Add-EntraAdministrativeUnitMember

Add-EntraAdministrativeUnitMember

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

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

As unidades administrativas permitem um gerenciamento mais granular de permissões e acesso, especialmente em grandes organizações ou em que as responsabilidades administrativas são divididas entre departamentos ou regiões.

Em cenários delegados, a adição de um usuário, grupo ou dispositivo a uma unidade administrativa requer:

• Administrador de Função Privilégiada

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 de unidade administrativa. Use Get-EntraAdministrativeUnit para localizar a ID da unidade administrativa e Get-EntraUser localizar a ID do usuário.

• AdministrativeUnitId o parâmetro especifica a ID de uma unidade administrativa.
• MemberId O parâmetro especifica a ID do usuário ou grupo que você deseja 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 de unidade administrativa. Use Get-EntraAdministrativeUnit para localizar a ID da unidade administrativa e Get-EntraGroup localizar a ID do grupo.

• AdministrativeUnitId o parâmetro especifica a ID de uma unidade administrativa.
• MemberId O parâmetro especifica a ID do usuário ou grupo que você deseja 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 de unidade administrativa. Use Get-EntraAdministrativeUnit para localizar a ID da unidade administrativa e Get-EntraDevice localizar a ID do dispositivo.

• AdministrativeUnitId o parâmetro especifica a ID de uma unidade administrativa.
• MemberId O parâmetro especifica a ID do dispositivo que você deseja 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.