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>]

説明

New-RdsRoleAssignment コマンドレットは、役割の割り当ての 3 つのプロパティ (役割、プリンシパル、スコープ) を指定して、役割の割り当てを作成します。

ロールを定義するには、次のいずれかのパラメータを使用できます。

  • RDSオーナー
  • RDS コントリビュータ
  • RDSリーダー
  • RDS Operator 各組み込みロールを理解するには、Get-RdsRoleDefinition を実行します。

プリンシパルを指定するには、次のいずれかのパラメータを使用できます。

  • サインインネーム
  • ApplicationId
  • グループオブジェクトID

スコープを定義するには、次のパラメーターを組み合わせて使用できます。

  • テナント グループ名
  • テナント名
  • ホストプール名
  • 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               :

このコマンドは、新しいロールの割り当てを作成し、"デスクトップ アプリケーション グループ" アプリ グループ スコープで RDS 所有者ロールを admin@contoso.com に割り当てます。

例 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 Host Pool" ホスト プール スコープの 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               :

このコマンドは、新しいロールの割り当てを作成し、指定した Azure AD グループに "contosoA" テナント スコープの 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" テナント スコープで RDS 共同作成者ロールを admin@contosob.com に割り当てます。 AadTenantId パラメーターは、Contoso A テナントに関連付けられている Azure AD テナントに admin@contosob.com が存在しないため、指定されます。

例 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" テナント グループ スコープで RDS 所有者ロールを admin@contoso.com に割り当てます。 テナント グループは特定の Azure AD テナントに関連付けられておらず、Windows Virtual Desktop はユーザーを解決する必要があるため、AadTenantId パラメーターが指定されます。

パラメーター

-AADTenantId

ユーザーの Azure Active Directory テナント ID。 これは、テナント グループのスコープでユーザーを割り当てるときに必要です。 これは、Windows Virtual Desktop テナントに関連付けられている Azure AD テナントにユーザーが存在しない場合に、テナント、ホスト プール、またはアプリ グループのスコープでユーザーを割り当てるときにも必要です。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-AppGroupName

アプリ グループの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ApplicationId

サービス プリンシパルのアプリケーション ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:SPN, サービスプリンシパルネーム

パラメーター セット

SPNRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Deployment

Windows Virtual Desktop に固有のスコープ。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-GroupObjectId

Azure AD グループのオブジェクト ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AADGroupId, ユーザーグループオブジェクト ID

パラメーター セット

GroupRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-HostPoolName

ホスト プールの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RoleDefinitionName

ロールの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentDeploymentScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentTenantScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentDeploymentScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentHostPoolScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentAppGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentDeploymentScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentHostPoolScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentAppGroupScopeParameterSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SignInName

ユーザーのユーザー プリンシパル名 (UPN)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Email, ユーザープリンシパルネーム

パラメーター セット

SignInNameRoleAssignmentDeploymentScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentTenantScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TenantGroupName

テナント グループの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TenantName

テナントの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SignInNameRoleAssignmentTenantScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SignInNameRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentTenantScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
SPNRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentTenantScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentHostPoolScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
GroupRoleAssignmentAppGroupScopeParameterSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

System.String

System.Management.Automation.SwitchParameter

出力

System.Object