Remove-RdsRoleAssignment

الوحدة النمطية:

Microsoft.RDInfra.RDPowershell Module

يزيل تعيين دور.

بناء الجملة

EmptyParameterSet (افتراضي)

Remove-RdsRoleAssignment
    [<CommonParameters>]

SignInNameRoleAssignmentDeploymentScopeParameterSet

Remove-RdsRoleAssignment
    [-TenantGroupName <String>]
    [-TenantName <String>]
    [-HostPoolName <String>]
    [-AppGroupName <String>]
    [<CommonParameters>]

SignInNameRoleAssignmentTenantGroupScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -SignInName <string>
    -TenantName <string>
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

SignInNameRoleAssignmentHostPoolScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -SignInName <string>
    -TenantName <string>
    -HostPoolName <string>
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

SignInNameRoleAssignmentAppGroupScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -SignInName <string>
    -TenantName <string>
    -HostPoolName <string>
    -AppGroupName <string>
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

SPNRoleAssignmentDeploymentScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -ApplicationId <string>
    -Deployment
    [<CommonParameters>]

SPNRoleAssignmentTenantGroupScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -ApplicationId <string>
    -TenantGroupName <string>
    [<CommonParameters>]

SPNRoleAssignmentTenantScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -ApplicationId <string>
    -TenantName <string>
    [-TenantGroupName <string>]
    [<CommonParameters>]

SPNRoleAssignmentHostPoolScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -ApplicationId <string>
    -TenantName <string>
    -HostPoolName <string>
    [-TenantGroupName <string>]
    [<CommonParameters>]

ServicePrincipalParameterSet

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

SPNRoleAssignmentAppGroupScopeParameterSet

Remove-RdsRoleAssignment
    [-RoleDefinitionName] <string>
    -ApplicationId <string>
    -TenantName <string>
    -HostPoolName <string>
    -AppGroupName <string>
    [-TenantGroupName <string>]
    [<CommonParameters>]

GroupRoleAssignmentDeploymentScopeParameterSet

Remove-RdsRoleAssignment
    -RoleDefinitionName <string>
    -GroupObjectId <string>
    -AADTenantId <string>
    -Deployment
    [<CommonParameters>]

GroupRoleAssignmentTenantGroupScopeParameterSet

Remove-RdsRoleAssignment
    -RoleDefinitionName <string>
    -GroupObjectId <string>
    -AADTenantId <string>
    -TenantGroupName <string>
    [<CommonParameters>]

GroupRoleAssignmentTenantScopeParameterSet

Remove-RdsRoleAssignment
    -RoleDefinitionName <string>
    -TenantName <string>
    [-GroupObjectId <string>]
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

GroupRoleAssignmentHostPoolScopeParameterSet

Remove-RdsRoleAssignment
    -RoleDefinitionName <string>
    -TenantName <string>
    -HostPoolName <string>
    [-GroupObjectId <string>]
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

GroupRoleAssignmentAppGroupScopeParameterSet

Remove-RdsRoleAssignment
    -RoleDefinitionName <string>
    -TenantName <string>
    -HostPoolName <string>
    -AppGroupName <string>
    [-GroupObjectId <string>]
    [-AADTenantId <string>]
    [-TenantGroupName <string>]
    [<CommonParameters>]

الوصف

يزيل Remove-RdsRoleAssignment cmdlet تعيين دور عن طريق تحديد الخصائص الثلاث لتعيين الدور: الدور والأساسي والنطاق.

لتحديد الدور، يمكنك استخدام إحدى المعلمات التالية:

• مالك RDS
• مساهم RDS
• قارئ RDS
• مشغل RDS

لتحديد المبدأ الأساسي، يمكنك استخدام إحدى المعلمات التالية:

• SignInName
• معرف التطبيق
• GroupObjectId

لتحديد النطاق، يمكنك استخدام مجموعة من المعلمات التالية:

• اسم TenantGroupName
• اسم المستأجر
• اسم HostPoolName
• AppGroupName

أمثلة

مثال 1: إزالة تعيين دور لمستخدم

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

يزيل هذا الأمر تعيين الدور لمن admin@contoso.com تم تعيينه لدور مالك RDS في نطاق مجموعة تطبيقات "مجموعة تطبيقات سطح المكتب".

مثال 2: إزالة تعيين دور لكيان خدمة

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

يزيل هذا الأمر تعيين الدور لكيان الخدمة المحدد الذي تم تعيينه لدور قارئ RDS في نطاق تجمع المضيف "contosoAHostPool".

مثال 3: إزالة تعيين دور لمجموعة Azure AD

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

يزيل هذا الأمر تعيين الدور لمجموعة Azure AD المحددة التي تم تعيينها لدور مشغل RDS في نطاق المستأجر "contosoA".

المعلمات

-AADTenantId

معرف مستأجر Azure Active Directory للمستخدم. هذا مطلوب عند تعيين مستخدم في نطاق مجموعة المستأجرين. هذا مطلوب أيضا عند تعيين مستخدم في المستأجر أو تجمع المضيف أو نطاق مجموعة التطبيقات عندما لا يكون موجودا في مستأجر Azure AD المقترن بمستأجر سطح المكتب الظاهري ل Windows.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	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
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-ApplicationId

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False
الأسماء المستعارة:	SPN, ServicePrincipalName

مجموعات المعلمات

ServicePrincipalParameterSet

Position:	Named
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-Deployment

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

خصائص المعلمات

النوع:	Switch
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-GroupObjectId

معرف العنصر لمجموعة Azure AD.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False
الأسماء المستعارة:	UserGroupObjectId

مجموعات المعلمات

GroupObjectIdParameterSet

Position:	Named
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-HostPoolName

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-RoleDefinitionName

اسم الدور.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

SignInNameParameterSet

Position:	0
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

ServicePrincipalParameterSet

Position:	0
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

GroupObjectIdParameterSet

Position:	0
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-SignInName

اسم المستخدم الأساسي (UPN) المتعلق بالمستخدم.

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False
الأسماء المستعارة:	البريد الإلكتروني, UserPrincipalName

مجموعات المعلمات

SignInNameParameterSet

Position:	Named
إلزامي:	True
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-TenantGroupName

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

-TenantName

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

خصائص المعلمات

النوع:	String
القيمة الافتراضية:	None
يدعم أحرف البدل:	False
DontShow:	False

مجموعات المعلمات

(All)

Position:	Named
إلزامي:	False
القيمة من مسار معالجة البيانات:	False
القيمة من مسار معالجة البيانات حسب اسم الخاصية:	True
القيمة من الوسائط المتبقية:	False

CommonParameters

يدعم cmdlet هذا المعلمات الشائعة: -Debug و -ErrorAction و -ErrorVariable و -InformationAction و -InformationVariable و -OutBuffer و -OutVariable و -PipelineVariable و -ProgressAction و -Verbose و -WarningAction و -WarningVariable. لمزيد من المعلومات، راجع about_CommonParameters.

الإدخالات

System.String

المخرجات

System.Object