Set-EntraAdministrativeUnit

Modulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Aggiorna le proprietà di un'unità amministrativa.

Sintassi

Default (Impostazione predefinita) 

Set-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [-Description <String>]
    [-DisplayName <String>]
    [-MembershipType <String>]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-Visibility <String>]
    [<CommonParameters>]

Descrizione

Il Set-EntraAdministrativeUnit cmdlet aggiorna le proprietà di un'unità amministrativa in Microsoft Entra ID. Specificare il AdministrativeUnitId parametro per aggiornare un'unità amministrativa specifica.

Negli scenari delegati, all'utente connesso deve essere assegnato un ruolo Microsoft Entra supportato o un ruolo personalizzato con l'autorizzazione microsoft.directory/administrativeUnits/allProperties/allTasks .

Per questa operazione sono supportati i ruoli con privilegi minimi seguenti:

  • Amministratore di ruolo privilegiato

Esempio

Esempio 1: Aggiornare DisplayName e descrizione

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Administrative Unit'"
Set-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id -DisplayName 'Pacific Admin Unit' -Description 'Pacific Admin Unit Description' -MembershipType 'Assigned'

Questo comando aggiorna DisplayName di un'unità amministrativa specifica.

  • -AdministrativeUnitId parametro specifica l'ID di un'unità amministrativa.
  • -DisplayName parametro specifica il nome visualizzato per l'unità amministrativa.
  • -Description parametro specifica la descrizione per l'unità amministrativa.

Parametri

-AdministrativeUnitId

Specifica l'ID di un'unità amministrativa in 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

-Description

Specifica una descrizione per l'unità amministrativa.

Proprietà dei parametri

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

Set di parametri

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

-DisplayName

Specifica un nome visualizzato per l'unità amministrativa.

Proprietà dei parametri

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

Set di parametri

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

-MembershipRule

Specifica la regola di appartenenza dinamica applicata all'unità amministrativa. I valori possibili sono: dynamic, assigned. Se non è impostato, il valore predefinito è null e il comportamento predefinito è assigned. Questo parametro è facoltativo.

Proprietà dei parametri

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

Set di parametri

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

-MembershipRuleProcessingState

Controlla se la regola di appartenenza dinamica è attiva. Impostare su per On abilitarlo o Paused arrestare gli aggiornamenti. Questo parametro è facoltativo.

Proprietà dei parametri

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

Set di parametri

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

-MembershipType

Specifica il tipo di appartenenza dell'unità amministrativa. I valori possibili sono: dynamic e assigned. Se non è impostato, il valore predefinito è nulle il tipo di appartenenza per impostazione predefinita è assigned. Questo parametro è facoltativo.

Proprietà dei parametri

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

Set di parametri

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

-Visibility

Specifica la visibilità dell'unità amministrativa. L'impostazione predefinita è public se non impostata. Impostare su HiddenMembership per nascondere l'appartenenza da membri non membri. Questo parametro è facoltativo.

Proprietà dei parametri

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

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
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.