你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzCosmosDBSqlRoleAssignment

模块:: Az.CosmosDB Module

更新现有的 CosmosDB Sql 角色分配。

语法

ByFieldsParameterSet (默认值)

Update-AzCosmosDBSqlRoleAssignment
    -ResourceGroupName <String>
    -AccountName <String>
    -Id <String>
    [-RoleDefinitionId <String>]
    [-RoleDefinitionName <String>]
    [-Scope <String>]
    [-PrincipalId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParentObjectParameterSet

Update-AzCosmosDBSqlRoleAssignment
    -Id <String>
    -ParentObject <PSSqlRoleDefinitionGetResults>
    [-Scope <String>]
    [-PrincipalId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectParameterSet

Update-AzCosmosDBSqlRoleAssignment
    -InputObject <PSSqlRoleAssignmentGetResults>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新现有的 CosmosDB Sql 角色分配。范围可以是完全限定的（即 /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/dbs/dbName），也可以以数据库名称（即 /dbs/dbName）开头。 RoleDefinitionId 和 Id 可以是完全限定的，也可以只是 Guid。

示例

示例 1

Update-AzCosmosDBSqlRoleAssignment `
	-AccountName accountName `
	-ResourceGroupName resourceGroupName `
	-Id roleAssignmentId `
	-RoleDefinitionId "/subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/sqlRoleDefinitions/roleDefinitionId"

Id               : /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/sqlRoleAssignments/roleAssignmentId
Scope            : /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/
RoleDefinitionId : /subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/sqlRoleDefinitions/roleDefinitionId
PrincipalId      : principalId

参数

-AccountName

Cosmos DB 数据库帐户的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Id

角色分配 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

ByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

角色分配对象。

参数属性

类型:	PSSqlRoleAssignmentGetResults
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ParentObject

CosmosDB Account 对象

参数属性

类型:	PSSqlRoleDefinitionGetResults
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PrincipalId

要向其授予角色分配的 AAD 主体的对象 ID （Guid）。这可能是用户、组、服务主体或托管标识。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

ByParentObjectParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RoleDefinitionId

完全限定的角色定义 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RoleDefinitionName

角色定义名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Scope

角色分配应授予访问权限的资源路径。 Eg. '/'，'/dbs/dbname'，'/dbs/dbname/colls/collname'。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByFieldsParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

ByParentObjectParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	False
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Update-AzCosmosDBSqlRoleAssignment

语法

ByFieldsParameterSet (默认值)

ByParentObjectParameterSet

ByObjectParameterSet

说明

示例

示例 1

参数

-AccountName

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Id

参数属性

参数集

-InputObject

参数属性

参数集

-ParentObject

参数属性

参数集

-PrincipalId

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-RoleDefinitionId

参数属性

参数集

-RoleDefinitionName

参数属性

参数集

-Scope

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

PSSqlRoleDefinitionGetResults

输出

PSSqlRoleDefinitionGetResults

反馈