Freigeben über

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 Rolle im Bereich der Verwaltungseinheit.

Beispiele

Beispiel 1: Entfernen eines Mitglieds aus einer Rolle im Bereich der Verwaltungseinheit

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

Im Beispiel wird elisadaugherty@contoso.com aus der Rolle "Benutzerkontoadministrator" entfernt, die für die Verwaltungseinheit "West Coast" vorgesehen ist. Nach diesem Beispiel ist der Benutzer nicht mehr Mitglied der Rolle.

Parameter

-AdministrativeUnitObjectId

Gibt die eindeutige Objekt-ID der Verwaltungseinheit an.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RoleMemberObjectId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RoleMemberUserPrincipalName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RoleObjectId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TenantId

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False