共用方式為


New-RdsRoleAssignment

建立角色指派。

語法

EmptyParameterSet (預設值)

New-RdsRoleAssignment
    [<CommonParameters>]

SignInNameRoleAssignmentDeploymentScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -SignInName <String>
    -AADTenantId <String>
    [-Deployment]
    [<CommonParameters>]

SignInNameRoleAssignmentTenantGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -SignInName <String>
    -TenantGroupName <String>
    -AADTenantId <String>
    [<CommonParameters>]

SignInNameRoleAssignmentTenantScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -SignInName <String>
    -TenantName <String>
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

SignInNameRoleAssignmentHostPoolScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -SignInName <String>
    -TenantName <String>
    -HostPoolName <String>
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

SignInNameRoleAssignmentAppGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -SignInName <String>
    -TenantName <String>
    -HostPoolName <String>
    -AppGroupName <String>
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

SPNRoleAssignmentDeploymentScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -ApplicationId <String>
    [-Deployment]
    [<CommonParameters>]

SPNRoleAssignmentTenantGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -ApplicationId <String>
    -TenantGroupName <String>
    [<CommonParameters>]

SPNRoleAssignmentTenantScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -ApplicationId <String>
    -TenantName <String>
    [-TenantGroupName <String>]
    [<CommonParameters>]

SPNRoleAssignmentHostPoolScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -ApplicationId <String>
    -TenantName <String>
    -HostPoolName <String>
    [-TenantGroupName <String>]
    [<CommonParameters>]

SPNRoleAssignmentAppGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -ApplicationId <String>
    -TenantName <String>
    -HostPoolName <String>
    -AppGroupName <String>
    [-TenantGroupName <String>]
    [<CommonParameters>]

GroupRoleAssignmentDeploymentScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -GroupObjectId <String>
    -AADTenantId <String>
    [-Deployment]
    [<CommonParameters>]

GroupRoleAssignmentTenantGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -GroupObjectId <String>
    -TenantGroupName <String>
    -AADTenantId <String>
    [<CommonParameters>]

GroupRoleAssignmentTenantScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -TenantName <String>
    [-GroupObjectId <String>]
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

GroupRoleAssignmentHostPoolScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -TenantName <String>
    -HostPoolName <String>
    [-GroupObjectId <String>]
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

GroupRoleAssignmentAppGroupScopeParameterSet

New-RdsRoleAssignment
    [-RoleDefinitionName] <String>
    -TenantName <String>
    -HostPoolName <String>
    -AppGroupName <String>
    [-GroupObjectId <String>]
    [-TenantGroupName <String>]
    [-AADTenantId <String>]
    [<CommonParameters>]

Description

New-RdsRoleAssignment cmdlet 通過指定角色分配的三個屬性(角色、主體和範圍)來創建角色分配。

要定義角色,您可以使用以下參數之一:

  • RDS 擁有者
  • RDS 貢獻者
  • RDS 讀取器
  • RDS作員要瞭解每個內置角色,請運行 Get-RdsRoleDefinition。

要指定委託人,您可以使用以下參數之一:

  • 登錄名稱
  • ApplicationId
  • 組物件ID

要定義範圍,您可以使用以下參數的組合:

  • 租戶組名稱
  • 租戶名稱
  • HostPool名稱
  • AppGroupName 應用程式組名稱

範例

範例 1:為使用者創建角色分配

PS C:\> New-RdsRoleAssignment -RoleDefinitionName "RDS Owner" -SignInName "admin@contoso.com" -TenantGroupName "Default Tenant Group" -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "Desktop Application Group"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /Default Tenant Group/contoso/contosoHostPool/Desktop Application Group
TenantGroupName    : Default Tenant Group
TenantName         : contoso
HostPoolName       : contosoHostPool
AppGroupName       : Desktop Application Group
DisplayName        : admin
SignInName         : admin@contoso.com
GroupObjectId      : aaaa-aaaa-aaaa-aaaa-aaaa
AADTenantId        : 0000-0000-0000-0000-0000
AppId              : yyyy-yyyy-yyyy-yyyy-yyyy
RoleDefinitionName : RDS Owner
RoleDefinitionId   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : User
Item               :

此命令將創建一個新的角色分配,並在「桌面應用程式組」應用程式組範圍內分配 admin@contoso.com RDS 擁有者角色。

示例 2:為服務主體創建角色分配

PS C:\> New-RdsRoleAssignment -RoleDefinitionName "RDS Reader" -ApplicationId "yyyy-yyyy-yyyy-yyyy-yyyy" -TenantGroupName "contosoTenantGroup" -TenantName "contosoA" -HostPoolName "contosoAHostPool"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoA/contosoAHostPool
TenantGroupName    : contosoTenantGroup
TenantName         : contosoA
HostPoolName       : contosoAHostPool
AppGroupName       :
DisplayName        :
SignInName         :
GroupObjectId      : 0000-0000-0000-0000-0000
AADTenantId        : 0000-0000-0000-0000-0000
AppId              : yyyy-yyyy-yyyy-yyyy-yyyy
RoleDefinitionName : RDS Reader
RoleDefinitionId   : 2ea11dc0-46e3-4ee8-f5db-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : ServicePrincipal
Item               :

此命令將創建一個新的角色分配,為指定的服務主體分配“Contoso A 主機池”主機池範圍內的 RDS 讀取者角色。

示例 3:為 Azure AD 組創建角色分配

PS C:\> New-RdsRoleAssignment -RoleDefinitionName "RDS Operator" -GroupObjectId "aaaa-aaaa-aaaa-aaaa-aaaa" -TenantGroupName "contosoTenantGroup" -TenantName "contosoA"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoA
TenantGroupName    : contosoTenantGroup
TenantName         : contosoA
DisplayName        :
SignInName         :
GroupObjectId      : aaaa-aaaa-aaaa-aaaa-aaaa
AADTenantId        : dddd-dddd-dddd-dddd-dddd
AppId              :
RoleDefinitionName : RDS Operator
RoleDefinitionId   : 827a079d-aa89-4d0d-f5dd-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : Group
Item               :

此命令將創建一個新的角色分配,在「contosoA」租戶範圍內為指定的 Azure AD 組分配 RDS 作員角色。

示例 4:為來自不同 Azure AD 租戶的用戶創建角色分配

PS C:\> New-RdsRoleAssignment -RoleDefinitionName "RDS Contributor" -SignInName "admin@contosob.com" -TenantGroupName "contosoTenantGroup" -TenantName "contosoA" -AadTenantId "xxxx-xxxx-xxxx-xxxx-xxxx"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoA
TenantGroupName    : contosoTenantGroup
TenantName         : contosoA
HostPoolName       :
AppGroupName       :
DisplayName        : admin
SignInName         : admin@contosob.com
GroupObjectId      : aaaa-aaaa-aaaa-aaaa-aaaa
AADTenantId        : 0000-0000-0000-0000-0000
AppId              : yyyy-yyyy-yyyy-yyyy-yyyy
RoleDefinitionName : RDS Owner
RoleDefinitionId   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : User
Item               :

此命令將創建一個新的角色分配,並在「contosoA」租戶範圍內分配 admin@contosob.com RDS 參與者角色。 指定 AadTenantId 參數是因為 admin@contosob.com 與 Contoso A 租戶關聯的 Azure AD 租戶中不存在該參數。

示例 5:在租戶組範圍內創建角色分配

PS C:\> New-RdsRoleAssignment -RoleDefinitionName "RDS Owner" -SignInName "admin@contoso.com" -TenantGroupName "contosoTenantGroup" -AadTenantId "xxxx-xxxx-xxxx-xxxx-xxxx"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup
TenantGroupName    : contosoTenantGroup
TenantName         :
HostPoolName       :
AppGroupName       :
DisplayName        : admin
SignInName         : admin@contoso.com
GroupObjectId      : aaaa-aaaa-aaaa-aaaa-aaaa
AADTenantId        : 0000-0000-0000-0000-0000
AppId              : yyyy-yyyy-yyyy-yyyy-yyyy
RoleDefinitionName : RDS Owner
RoleDefinitionId   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : User
Item               :

此命令將創建一個新的角色分配,並在「contosoTenantGroup」租戶組範圍內分配 admin@contoso.com RDS 擁有者角色。 指定 AadTenantId 參數是因為租戶組未與任何特定的 Azure AD 租戶關聯,並且 Windows 虛擬桌面必須解析使用者。

參數

-AADTenantId

使用者的 Azure Active Directory 租戶 ID。 在租戶組範圍內分配使用者時,這是必需的。 在租戶、主機池或應用組範圍內分配使用者時,如果與 Windows 虛擬桌面租戶關聯的 Azure AD 租戶中不存在這些使用者,則也需要這樣做。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-AppGroupName

應用組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ApplicationId

服務主體的應用程式ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:服務主體名稱 (SPN), 服務主體名稱

參數集

SPNRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Deployment

特定於 Windows 虛擬桌面的範圍。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-GroupObjectId

Azure AD 組的物件 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:AADGroupId, 用戶組物件ID

參數集

GroupRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-HostPoolName

主機池的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RoleDefinitionName

角色的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentDeploymentScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentTenantScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentDeploymentScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentHostPoolScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentAppGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentDeploymentScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentHostPoolScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentAppGroupScopeParameterSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SignInName

使用者的使用者主體名稱 (UPN) 。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:Email, 使用者主要名稱 (UserPrincipalName)

參數集

SignInNameRoleAssignmentDeploymentScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentTenantScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-TenantGroupName

租戶組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-TenantName

租用戶的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SignInNameRoleAssignmentTenantScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentTenantScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SPNRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentTenantScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentHostPoolScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
GroupRoleAssignmentAppGroupScopeParameterSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

System.String

System.Management.Automation.SwitchParameter

輸出

System.Object