مشاركة عبر


Get-RdsRoleAssignment

يسرد تعيينات الأدوار في نطاق محدد.

بناء الجملة

Get-RdsRoleAssignment
   [-SignInName <String>]
   [-TenantGroupName <String>]
   [-TenantName <String>]
   [-HostPoolName <String>]
   [-AppGroupName <String>]
   [<CommonParameters>]
Get-RdsRoleAssignment
   [-SignInName <String>]
   [-TenantGroupName <String>]
   [-TenantName <String>]
   [-HostPoolName <String>]
   [-AppGroupName <String>]
   [<CommonParameters>]
Get-RdsRoleAssignment
   [-ServicePrincipalName <String>]
   [-TenantGroupName <String>]
   [-TenantName <String>]
   [-HostPoolName <String>]
   [-AppGroupName <String>]
   [<CommonParameters>]
Get-RdsRoleAssignment
   [-GroupObjectId <String>]
   [-TenantGroupName <String>]
   [-TenantName <String>]
   [-HostPoolName <String>]
   [-AppGroupName <String>]
   [<CommonParameters>]

الوصف

يسرد Get-RdsRoleAssignment cmdlet جميع تعيينات الأدوار في النطاق المحدد. بدون أي معلمات، يقوم هذا الأمر بإرجاع كافة تعيينات الدور بدءا من أعلى نطاق مصرح به للمستخدم الحالي. لتعريف النطاق، يمكنك استخدام مجموعة من المعلمات التالية:

  • TenantGroupName
  • اسم المستأجر
  • اسم المضيف
  • اسم مجموعة التطبيقات

يمكن أيضا تصفية هذه القائمة عن طريق تحديد أساس تعيين الدور. لتحديد الأساسي، يمكنك استخدام إحدى المعلمات التالية:

  • SignInName
  • ServicePrincipalName
  • GroupObjectId

أمثلة

مثال 1: سرد كافة تعيينات الأدوار

PS C:\> Get-RdsRoleAssignment

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        : xxxx-xxxx-xxxx-xxxx-xxxx
AppId              : yyyy-yyyy-yyyy-yyyy-yyyy
RoleDefinitionName : RDS Owner
RoleDefinitionId   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : User
Item               :

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /Default Tenant Group/contoso
TenantGroupName    : Default Tenant Group
TenantName         : contoso
HostPoolName       : 
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   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : ServicePrincipal
Item               :

يحصل هذا الأمر على كافة تعيينات الأدوار في السياق الحالي، بدءا من أعلى نطاق مصرح به للمستخدم الحالي.

مثال 2: سرد تعيينات الأدوار لمستخدم

PS C:\> Get-RdsRoleAssignment -SignInName "admin@contoso.com"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoA/contosoAHostPool/Desktop Application Group
TenantGroupName    : contosoTenantGroup
TenantName         : contosoA
HostPoolName       : contosoAHostPool
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               :

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoB/contosoBHostPool/Desktop Application Group
TenantGroupName    : contosoTenantGroup
TenantName         : contosoB
HostPoolName       : contosoBHostPool
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 Reader
RoleDefinitionId   : 2ea11dc0-46e3-4ee8-f5db-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : User
Item               :

يحصل هذا الأمر على كافة تعيينات الأدوار للمستخدم المحدد في السياق الحالي.

مثال 3: سرد تعيينات الأدوار لمدير الخدمة

PS C:\> Get-RdsRoleAssignment -ServicePrincipalName "yyyy-yyyy-yyyy-yyyy-yyyy"

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               :

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoB/contosoBHostPool/Desktop Application Group
TenantGroupName    : contosoTenantGroup
TenantName         : contosoB
HostPoolName       : contosoBHostPool
AppGroupName       : Desktop Application Group
DisplayName        : 
SignInName         : 
GroupObjectId      : 0000-0000-0000-0000-0000
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         : ServicePrincipal
Item               :

يحصل هذا الأمر على كافة تعيينات الأدوار لمدير الخدمة المحدد في السياق الحالي. يجب توفير معرف التطبيق الخاص بكيان الخدمة كقيمة للمعلمة .

مثال 4: سرد تعيينات الأدوار لمجموعة Azure AD

PS C:\> Get-RdsRoleAssignment -GroupObjectId "aaaa-aaaa-aaaa-aaaa-aaaa"

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoA
TenantGroupName    : contosoTenantGroup
TenantName         : contosoA
HostPoolName       : 
AppGroupName       : 
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               :

RoleAssignmentId   : cccc-cccc-cccc-cccc-cccc
Scope              : /contosoTenantGroup/contosoB/contosoBHostPool/Desktop Application Group
TenantGroupName    : contosoTenantGroup
TenantName         : contosoB
HostPoolName       : ontosoBHostPool
AppGroupName       : Desktop Application Group
DisplayName        : 
SignInName         : 
GroupObjectId      : aaaa-aaaa-aaaa-aaaa-aaaa
AADTenantId        : dddd-dddd-dddd-dddd-dddd
AppId              : 
RoleDefinitionName : RDS Owner
RoleDefinitionId   : 3b14baea-8d82-4610-f5da-08d623dd1cc4
ObjectId           : bbbb-bbbb-bbbb-bbbb-bbbb
ObjectType         : Group
Item               :

يحصل هذا الأمر على كافة تعيينات الأدوار لمجموعة Azure AD المحددة في السياق الحالي.

المعلمات

-AppGroupName

اسم مجموعة التطبيقات.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-Deployment

نطاق خاص بسطح المكتب الظاهري ل Windows.

النوع:Switch
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-GroupObjectId

معرف الكائن لمجموعة Azure AD لتصفية تعيينات الأدوار.

النوع:String
الأسماء المستعارة:UserGroupObjectId
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-HostPoolName

اسم تجمع المضيف.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-ServicePrincipalName

معرف التطبيق الخاص بكيان الخدمة لتصفية تعيينات الأدوار.

النوع:String
الأسماء المستعارة:SPN, ApplicationId
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-SignInName

اسم المستخدم الأساسي (UPN) للمستخدم لتصفية تعيينات الأدوار.

النوع:String
الأسماء المستعارة:Email, UserPrincipalName
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-TenantGroupName

اسم مجموعة المستأجرين.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

-TenantName

اسم المستأجر.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:True
قبول أحرف البدل:False

الإدخالات

System.String

المخرجات

System.Object