Remove-MsolScopedRoleMember

  • Referenz
Modul:
MSOnline

Entfernt einen Benutzer aus einer Verwaltungseinheitsrolle.

Syntax

Remove-MsolScopedRoleMember
      -RoleObjectId <Guid>
      -AdministrativeUnitObjectId <Guid>
      [-RoleMemberObjectId <Guid>]
      [-RoleMemberUserPrincipalName <String>]
      [-TenantId <Guid>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-MsolScopedRoleMember entfernt einen Benutzer aus einer Verwaltungseinheitsrolle.

Beispiele

Beispiel 1: Entfernen eines Members aus einer Verwaltungseinheitsrolle

PS C:\> $WestCoastAu = Get-MsolAdministrativeUnit -SearchString "West Coast"
PS C:\> $UaAdmin = Get-MsolRole -RoleName "User Account Administrator"
PS C:\> $Admin01 = Get-MsolUser -UserPrincipalName "elisadaugherty@contoso.com"
PS C:\> Remove-MsolScopedRoleMember -RoleObjectId $UaAdmin.ObjectId -AdministrativeUnitObjectId $WestCoastAu.ObjectId -RoleMemberObjectId $Admin01.ObjectId

Das Beispiel entfernt elisadaugherty@contoso.com die Rolle "Benutzerkontoadministrator" für die Verwaltungseinheit "West Coast". Nach diesem Beispiel ist der Benutzer kein Mitglied der Rolle mehr.

Parameter

-AdministrativeUnitObjectId

Gibt die eindeutige Objekt-ID der Verwaltungseinheit an.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleMemberObjectId

Gibt die eindeutige Objekt-ID des Members an, die aus der Rolle entfernt werden soll, die auf die Verwaltungseinheit festgelegt ist. Geben Sie entweder den RoleMemberUserPrincipalName oder RoleMemberObjectId-Parameter an.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RoleMemberUserPrincipalName

Gibt den Benutzerprinzipalnamen des zu entfernenden Elements an. Geben Sie entweder RoleMemberUserPrincipalName oder RoleMemberObjectId an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RoleObjectId

Gibt die eindeutige Objekt-ID der Rolle an, aus der Mitglieder entfernt werden sollen.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Gibt die eindeutige ID des Mandanten an, auf der der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandanten des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False