Update-AzCosmosDBTableRoleDefinition

Module:
Az.CosmosDB Module

Hiermee wordt een bestaande CosmosDB-tabelroldefinitie bijgewerkt.

Syntax

ByFieldsParameterSet (Standaard) 

Update-AzCosmosDBTableRoleDefinition
    -ResourceGroupName <String>
    -AccountName <String>
    -Id <String>
    [-Type <String>]
    [-RoleName <String>]
    [-DataAction <System.Collections.Generic.List`1[System.String]>]
    [-Permission <System.Collections.Generic.List`1[Microsoft.Azure.Commands.CosmosDB.Models.PSPermission]>]
    [-AssignableScope <System.Collections.Generic.List`1[System.String]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParentObjectParameterSet 

Update-AzCosmosDBTableRoleDefinition
    -Id <String>
    -ParentObject <PSDatabaseAccountGetResults>
    [-Type <String>]
    [-RoleName <String>]
    [-DataAction <System.Collections.Generic.List`1[System.String]>]
    [-Permission <System.Collections.Generic.List`1[Microsoft.Azure.Commands.CosmosDB.Models.PSPermission]>]
    [-AssignableScope <System.Collections.Generic.List`1[System.String]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectParameterSet 

Update-AzCosmosDBTableRoleDefinition
    -InputObject <PSTableRoleDefinitionGetResults>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Hiermee wordt een bestaande CosmosDB-tabelroldefinitie bijgewerkt. Toewijsbare bereiken kunnen volledig gekwalificeerd zijn (bijvoorbeeld /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft. DocumentDB/databaseAccounts/accountName/dbs/dbName) of begin met de databasenaam (ie. /dbs/dbName). De id kan volledig zijn gekwalificeerd of alleen de GUID. Als u de machtigingen van de roldefinitie wilt opgeven, gebruikt u de Parameter DataAction en geeft u een lijst met tekenreeksen door die worden omgezet in één machtigingsobject, of gebruikt u de New-AzCosmosDBPermission-cmdlet om PSPermission-objecten te maken die moeten worden doorgegeven via de parameter Machtiging.

Voorbeelden

Voorbeeld 1

Update-AzCosmosDBTableRoleDefinition `
	-AccountName accountName `
	-ResourceGroupName resourceGroupName `
	-Id id `
	-Type CustomRole `
	-RoleName roleName `
	-DataAction "Microsoft.DocumentDB/databaseAccounts/tableDatabases/containers/items/create" `
	-AssignableScope "/"

RoleName         : roleName
Id               : /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/tableRoleDefinitions/id
Type             : CustomRole
Permissions      : {Microsoft.Azure.Management.CosmosDB.Models.Permission}
AssignableScopes : {/subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName}

Voorbeeld 2: Machtiging en ParentObject gebruiken

$DatabaseAccount = Get-AzCosmosDBAccount -Name accountName -ResourceGroupName resourceGroupName
$Permission = New-AzCosmosDBPermission -DataAction "Microsoft.DocumentDB/databaseAccounts/tableDatabases/containers/items/create"
Update-AzCosmosDBTableRoleDefinition `
	-Type CustomRole `
	-Id id `
	-RoleName roleName `
	-Permission $Permission `
	-AssignableScope "/" `
	-ParentObject $DatabaseAccount

RoleName         : roleName
Id               : /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/tableRoleDefinitions/id
Type             : CustomRole
Permissions      : {Microsoft.Azure.Management.CosmosDB.Models.Permission}
AssignableScopes : {/subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName}

Parameters

-AccountName

Naam van het Cosmos DB-databaseaccount.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AssignableScope

Set resourcepaden waaronder een roltoewijzing kan worden gekoppeld aan de roldefinitie. Eg. '/', '/dbs/dbname','/dbs/dbname/colls/collname'.

Parametereigenschappen

Type:

List<T>[String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DataAction

Set gegevensacties die worden verleend via de roldefinitie. De lijst met toegestane acties vindt u op: https://aka.ms/cosmos-native-rbac

Parametereigenschappen

Type:

List<T>[String]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

Roldefinitie-id.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

CosmosDB-accountobject

Parametereigenschappen

Type:PSTableRoleDefinitionGetResults
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByObjectParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ParentObject

CosmosDB-accountobject

Parametereigenschappen

Type:PSDatabaseAccountGetResults
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByParentObjectParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Permission

Machtiging is een verzameling gegevensacties.

Parametereigenschappen

Type:

List<T>[PSPermission]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Naam van resourcegroep.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RoleName

Naam van roldefinitie.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Type

Type roldefinitie, CustomRole of BuiltInRole. De standaardwaarde is CustomRole.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ByFieldsParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ByParentObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Microsoft.Azure.Commands.CosmosDB.Models.PSDatabaseAccount

Uitvoerwaarden

PSThroughputSettingsGetResults