Add-EntraAdministrativeUnitMember

Add-EntraAdministrativeUnitMember

    -MemberId <String>
    -AdministrativeUnitId <String>
    [<CommonParameters>]

O Add-EntraAdministrativeUnitMember cmdlet adiciona um membro da unidade administrativa do Microsoft Entra ID.

As unidades administrativas permitem uma gestão mais detalhada das permissões e acessos, especialmente em grandes organizações ou onde as responsabilidades administrativas estão divididas entre departamentos ou regiões.

Em cenários delegados, adicionar um utilizador, grupo ou dispositivo a uma unidade administrativa requer:

• Administrador de Função Privilegiada

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $user.Id

Este exemplo demonstra a adição de um membro da unidade administrativa. Use Get-EntraAdministrativeUnit para encontrar o ID da unidade administrativa e Get-EntraUser para encontrar o ID do utilizador.

• AdministrativeUnitId o parâmetro especifica o ID de uma unidade administrativa.
• MemberId o parâmetro especifica o ID do utilizador ou grupo que pretende adicionar como membro da unidade administrativa.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$group = Get-EntraGroup -SearchString 'Sales and Marketing'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $group.Id

Este exemplo demonstra a adição de um membro da unidade administrativa. Use Get-EntraAdministrativeUnit para encontrar o ID da unidade administrativa e Get-EntraGroup para encontrar o ID do grupo.

• AdministrativeUnitId o parâmetro especifica o ID de uma unidade administrativa.
• MemberId o parâmetro especifica o ID do utilizador ou grupo que pretende adicionar como membro da unidade administrativa.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$device = Get-EntraDevice -SearchString 'ContosoDesktop01'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $device.Id

Este exemplo demonstra a adição de um membro da unidade administrativa. Use Get-EntraAdministrativeUnit para encontrar o ID da unidade administrativa e Get-EntraDevice para encontrar o ID do dispositivo.

• AdministrativeUnitId o parâmetro especifica o ID de uma unidade administrativa.
• MemberId parameter especifica o ID do dispositivo que pretende adicionar como membro da unidade administrativa.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.