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.
-
AdministrativeUnitIdparametro specifica l'ID di un'unità amministrativa. -
MemberIdparametro 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.
-
AdministrativeUnitIdparametro specifica l'ID di un'unità amministrativa. -
MemberIdparametro 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.
-
AdministrativeUnitIdparametro specifica l'ID di un'unità amministrativa. -
MemberIdparametro 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.