Remove-MsolScopedRoleMember

  • Referencia
Módulo:
MSOnline

Quita un usuario de un rol de ámbito de unidad administrativa.

Syntax

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

Description

El cmdlet Remove-MsolScopedRoleMember quita un usuario de un rol de ámbito de unidad administrativa.

Ejemplos

Ejemplo 1: Quitar un miembro de un rol de ámbito de unidad administrativa

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

En el ejemplo se elisadaugherty@contoso.com quita del rol Administrador de cuentas de usuario con el ámbito de la unidad administrativa denominada Costa Oeste. Después de este ejemplo, el usuario ya no es miembro del rol.

Parámetros

-AdministrativeUnitObjectId

Especifica el identificador de objeto único de la unidad administrativa.

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

-RoleMemberObjectId

Especifica el identificador de objeto único del miembro que se va a quitar del rol con ámbito a la unidad administrativa. Especifique el parámetro RoleMemberUserPrincipalName o RoleMemberObjectId .

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

-RoleMemberUserPrincipalName

Especifica el nombre principal de usuario del miembro que se va a quitar. Especifique RoleMemberUserPrincipalName o RoleMemberObjectId.

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

-RoleObjectId

Especifica el identificador de objeto único del rol del que se van a quitar miembros.

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

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

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