Remove-RdsRoleAssignment

Modul:: Microsoft.RDInfra.RDPowershell Module

Menghapus penetapan peran.

Sintaks

EmptyParameterSet (Default)

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

Deskripsi

Cmdlet Remove-RdsRoleAssignment menghapus penetapan peran dengan menentukan tiga properti penetapan peran: peran, peran, dan cakupan.

Untuk menentukan peran, Anda dapat menggunakan salah satu parameter berikut:

Pemilik RDS
Kontributor RDS
Pembaca RDS
RDS Operator

Untuk menentukan prinsipal, Anda dapat menggunakan salah satu parameter berikut:

Nama Masuk
ApplicationId
GroupObjectId

Untuk menentukan cakupan, Anda dapat menggunakan kombinasi parameter berikut:

TenantGroupName
NamaPenyewa
Nama HostPool
Nama Grup Aplikasi

Contoh

Contoh 1: Menghapus penetapan peran untuk pengguna

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

Perintah ini menghapus penetapan peran untuk admin@contoso.com siapa yang ditetapkan ke peran Pemilik RDS di cakupan grup aplikasi "Grup Aplikasi Desktop".

Contoh 2: Menghapus penetapan peran untuk perwakilan layanan

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

Perintah ini menghapus penetapan peran untuk perwakilan layanan yang ditentukan yang ditetapkan ke peran Pembaca RDS di cakupan kumpulan host "contosoAHostPool".

Contoh 3: Menghapus penetapan peran untuk grup Azure Active Directory

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

Perintah ini menghapus penetapan peran untuk grup Azure Active Directory yang ditentukan yang ditetapkan ke peran Operator RDS pada cakupan penyewa "contosoA".

Parameter

-AADTenantId

ID penyewa Azure Active Directory pengguna. Ini diperlukan saat menetapkan pengguna di cakupan grup penyewa. Ini juga diperlukan saat menetapkan pengguna di cakupan penyewa, kumpulan host, atau grup aplikasi saat mereka tidak ada di penyewa Azure Active Directory yang terkait dengan penyewa Windows Virtual Desktop.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

SignInNameRoleAssignmentDeploymentScopeParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

SignInNameRoleAssignmentTenantGroupScopeParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

GroupRoleAssignmentDeploymentScopeParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

GroupRoleAssignmentTenantGroupScopeParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-AppGroupName

Nama grup aplikasi.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ApplicationId

ID aplikasi perwakilan layanan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	SPN, NamaPrincipaLayanan

Set parameter

ServicePrincipalParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Deployment

Cakupan khusus untuk Windows Virtual Desktop.

Properti parameter

Jenis:	Switch
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-GroupObjectId

ID objek grup Azure Active Directory.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	UserGroupObjectId

Set parameter

GroupObjectIdParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-HostPoolName

Nama kumpulan host.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RoleDefinitionName

Nama peran.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

SignInNameParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

ServicePrincipalParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

GroupObjectIdParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SignInName

Nama prinsipal pengguna (UPN) dari pengguna.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Email, Nama Pokok Pengguna

Set parameter

SignInNameParameterSet

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-TenantGroupName

Nama grup penyewa.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-TenantName

Nama penyewa.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Bagikan melalui

Remove-RdsRoleAssignment

Sintaks

EmptyParameterSet (Default)

SignInNameRoleAssignmentDeploymentScopeParameterSet

SignInNameRoleAssignmentTenantGroupScopeParameterSet

SignInNameRoleAssignmentHostPoolScopeParameterSet

SignInNameRoleAssignmentAppGroupScopeParameterSet

SPNRoleAssignmentDeploymentScopeParameterSet

SPNRoleAssignmentTenantGroupScopeParameterSet

SPNRoleAssignmentTenantScopeParameterSet

SPNRoleAssignmentHostPoolScopeParameterSet

ServicePrincipalParameterSet

SPNRoleAssignmentAppGroupScopeParameterSet

GroupRoleAssignmentDeploymentScopeParameterSet

GroupRoleAssignmentTenantGroupScopeParameterSet

GroupRoleAssignmentTenantScopeParameterSet

GroupRoleAssignmentHostPoolScopeParameterSet

GroupRoleAssignmentAppGroupScopeParameterSet

Deskripsi

Contoh

Contoh 1: Menghapus penetapan peran untuk pengguna

Contoh 2: Menghapus penetapan peran untuk perwakilan layanan

Contoh 3: Menghapus penetapan peran untuk grup Azure Active Directory

Parameter

-AADTenantId

Properti parameter

Set parameter

-AppGroupName

Properti parameter

Set parameter

-ApplicationId

Properti parameter

Set parameter

-Deployment

Properti parameter

Set parameter

-GroupObjectId

Properti parameter

Set parameter

-HostPoolName

Properti parameter

Set parameter

-RoleDefinitionName

Properti parameter

Set parameter

-SignInName

Properti parameter

Set parameter

-TenantGroupName

Properti parameter

Set parameter

-TenantName

Properti parameter

Set parameter

CommonParameters

Input

System.String

Output

System.Object