Delen via

Remove-MsolScopedRoleMember

  • Referentie
Module:
MSOnline

Hiermee verwijdert u een gebruiker uit een rol binnen het bereik van een beheereenheid.

Syntax

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

Description

Met de cmdlet Remove-MsolScopedRoleMember verwijdert u een gebruiker uit een rol binnen het bereik van een beheereenheid.

Voorbeelden

Voorbeeld 1: Een lid verwijderen uit een rol binnen het bereik van een beheereenheid

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

In het voorbeeld wordt elisadaugherty@contoso.com de rol Beheerder van het gebruikersaccount verwijderd voor de beheereenheid met de naam Westkust. Na dit voorbeeld is de gebruiker geen lid meer van de rol.

Parameters

-AdministrativeUnitObjectId

Hiermee geeft u de unieke object-id van de beheereenheid.

Type:Guid
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleMemberObjectId

Hiermee geeft u de unieke object-id van het lid te verwijderen uit de rol die is gericht op de beheereenheid. Geef de parameter RoleMemberUserPrincipalName of RoleMemberObjectId op .

Type:Guid
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-RoleMemberUserPrincipalName

Hiermee geeft u de user principal name op van het lid dat moet worden verwijderd. Geef RoleMemberUserPrincipalName of RoleMemberObjectId op.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-RoleObjectId

Hiermee geeft u de unieke object-id van de rol waaruit leden te verwijderen.

Type:Guid
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

Type:Guid
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False