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

New-AzCosmosDBSqlRoleAssignment

模块:: Az.CosmosDB Module

创建新的 CosmosDB Sql 角色分配。

语法

ByFieldsParameterSet （默认值）

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

ByNameParameterSet

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

ByParentObjectParameterSet

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

说明

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

示例

示例 1

New-AzCosmosDBSqlRoleAssignment `
	-AccountName accountName `
	-ResourceGroupName resourceGroupName `
	-RoleDefinitionId "/subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName/sqlRoleDefinitions/roleDefinitionId" `
	-Scope "/subscriptions/subId/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/accountName" `
	-PrincipalId principalId

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

ByNameParameterSet

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

参数集

(All)

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

-ParentObject

角色定义对象。

参数属性

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

参数集

ByParentObjectParameterSet

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

-PrincipalId

角色分配的 Guid 主体 ID。

参数属性

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

参数集

(All)

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

-ResourceGroupName

资源组的名称。

参数属性

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

参数集

ByFieldsParameterSet

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

ByNameParameterSet

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

-RoleDefinitionId

角色定义 ID。

参数属性

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

参数集

ByFieldsParameterSet

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

-RoleDefinitionName

角色定义名称

参数属性

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

参数集

ByNameParameterSet

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

-Scope

范围。

参数属性

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

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	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。

通过

New-AzCosmosDBSqlRoleAssignment

语法

ByFieldsParameterSet （默认值）

ByNameParameterSet

ByParentObjectParameterSet

说明

示例

示例 1

参数

-AccountName

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Id

参数属性

参数集

-ParentObject

参数属性

参数集

-PrincipalId

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-RoleDefinitionId

参数属性

参数集

-RoleDefinitionName

参数属性

参数集

-Scope

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

PSSqlRoleDefinitionGetResults

输出

PSSqlRoleAssignmentGetResults

反馈