Add-EntraAdministrativeUnitMember

Aggiunge un membro dell'unità amministrativa.

Sintassi

Default (Impostazione predefinita)

Add-EntraAdministrativeUnitMember

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

Descrizione

Il Add-EntraAdministrativeUnitMember cmdlet aggiunge un membro dell'unità amministrativa Microsoft Entra ID.

Le unità amministrative consentono una gestione più granulare delle autorizzazioni e dell'accesso, in particolare nelle organizzazioni di grandi dimensioni o in cui le responsabilità amministrative sono suddivise in reparti o aree geografiche.

Negli scenari delegati è necessario aggiungere un utente, un gruppo o un dispositivo a un'unità amministrativa:

  • Amministratore di ruolo privilegiato

Esempio

Esempio 1: Aggiungere un utente come membro dell'unità amministrativa

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

In questo esempio viene illustrato l'aggiunta di un membro dell'unità amministrativa. Usare Get-EntraAdministrativeUnit per trovare l'ID unità amministrativa e Get-EntraUser per trovare l'ID utente.

  • AdministrativeUnitId parametro specifica l'ID di un'unità amministrativa.
  • MemberId parametro specifica l'ID dell'utente o del gruppo da aggiungere come membro dell'unità amministrativa.

Esempio 2: Aggiungere un gruppo a un'unità amministrativa

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

In questo esempio viene illustrato l'aggiunta di un membro dell'unità amministrativa. Usare Get-EntraAdministrativeUnit per trovare l'ID unità amministrativa e Get-EntraGroup per trovare l'ID gruppo.

  • AdministrativeUnitId parametro specifica l'ID di un'unità amministrativa.
  • MemberId parametro specifica l'ID dell'utente o del gruppo da aggiungere come membro dell'unità amministrativa.

Esempio 3: Aggiungere un dispositivo a un'unità amministrativa

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

In questo esempio viene illustrato l'aggiunta di un membro dell'unità amministrativa. Usare Get-EntraAdministrativeUnit per trovare l'ID unità amministrativa e Get-EntraDevice per trovare l'ID dispositivo.

  • AdministrativeUnitId parametro specifica l'ID di un'unità amministrativa.
  • MemberId parametro specifica l'ID del dispositivo da aggiungere come membro dell'unità amministrativa.

Parametri

-AdministrativeUnitId

Specifica l'ID di un'unità amministrativa Microsoft Entra ID.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-MemberId

Specifica l'ID univoco dell'oggetto Microsoft Entra ID specifico che sono proprietario/manager/membro.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:RefObjectId

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.