Set-EntraAdministrativeUnit

Moduł:
Microsoft.Entra.DirectoryManagement Module v1.3

Aktualizuje właściwości jednostki administracyjnej.

Składnia

Default (domyślnie) 

Set-EntraAdministrativeUnit

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

Opis

Polecenie Set-EntraAdministrativeUnit cmdlet aktualizuje właściwości jednostki administracyjnej w Microsoft Entra ID. Określ AdministrativeUnitId parametr, aby zaktualizować określoną jednostkę administracyjną.

W scenariuszach delegowanych zalogowany użytkownik musi mieć przypisaną obsługiwaną rolę Microsoft Entra lub rolę niestandardową z uprawnieniemmicrosoft.directory/administrativeUnits/allProperties/allTasks.

Następujące role z najniższymi uprawnieniami są obsługiwane dla tej operacji:

  • Administrator ról uprzywilejowanych

Przykłady

Przykład 1. Aktualizowanie nazwy displayname i opisu

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'

To polecenie zaktualizuj displayName określonej jednostki administracyjnej.

  • -AdministrativeUnitId parametr określa identyfikator jednostki administracyjnej.
  • -DisplayName parametr określa nazwę wyświetlaną jednostki administracyjnej.
  • -Description parametr określa opis jednostki administracyjnej.

Parametry

-AdministrativeUnitId

Określa identyfikator jednostki administracyjnej w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Description

Określa opis jednostki administracyjnej.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

Określa nazwę wyświetlaną jednostki administracyjnej.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MembershipRule

Określa regułę członkostwa dynamicznego zastosowaną do jednostki administracyjnej. Możliwe wartości to: dynamic, assigned. Jeśli nie zostanie ustawiona, wartość domyślna to null , a domyślne zachowanie to assigned. Ten parametr jest opcjonalny.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MembershipRuleProcessingState

Określa, czy reguła członkostwa dynamicznego jest aktywna. Ustaw wartość , aby On ją włączyć lub Paused zatrzymać aktualizacje. Ten parametr jest opcjonalny.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MembershipType

Określa typ członkostwa jednostki administracyjnej. Możliwe wartości to: dynamic i assigned. Jeśli nie zostanie ustawiona, wartość domyślna to null, a typ członkostwa ma assignedwartość domyślną . Ten parametr jest opcjonalny.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Visibility

Określa widoczność jednostki administracyjnej. Wartość domyślna to public , jeśli nie jest ustawiona. Ustaw wartość na , aby HiddenMembership ukryć członkostwo przed członkami niebędącymi członkami. Ten parametr jest opcjonalny.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.