Set-AzureADUser
Aktualizuje użytkownika.
Składnia
Set-AzureADUser
-ObjectId <String>
[-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-AccountEnabled <Boolean>]
[-AgeGroup <String>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-CreationType <String>]
[-Department <String>]
[-DisplayName <String>]
[-FacsimileTelephoneNumber <String>]
[-GivenName <String>]
[-IsCompromised <Boolean>]
[-ImmutableId <String>]
[-JobTitle <String>]
[-MailNickName <String>]
[-Mobile <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-PasswordPolicies <String>]
[-PasswordProfile <PasswordProfile>]
[-PhysicalDeliveryOfficeName <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-ShowInAddressList <Boolean>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-TelephoneNumber <String>]
[-UsageLocation <String>]
[-UserPrincipalName <String>]
[-UserState <String>]
[-UserStateChangedOn <String>]
[-UserType <String>]
[<CommonParameters>] Opis
Polecenie cmdlet Set-AzureADUser aktualizuje użytkownika w usłudze Azure Active Directory (AD).
Przykłady
Przykład 1. Aktualizowanie użytkownika
PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.DisplaynamePrzykład 2: Ustawianie wszystkich, ale określonych użytkowników jako nieletnich z zgodą rodziców
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }To polecenie aktualizuje właściwość określonego użytkownika.
Parametry
-AccountEnabled
Wskazuje, czy konto jest włączone.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-AgeGroup
Używane przez aplikacje dla przedsiębiorstw do określania legalnej grupy wiekowej użytkownika. Ta właściwość jest tylko do odczytu i obliczana na podstawie właściwości ageGroup i consentProvidedForMinor . Dozwolone wartości: null, minornotAdult i adult. Zapoznaj się z [legalnymi definicjami właściwości grupy wiekowej][Dowiedz się więcej o grupach wiekowych i drobnych definicjach zgody].
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-City
Określa miasto użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CompanyName
Nazwa firmy, z którą jest skojarzony użytkownik. Ta właściwość może być przydatna do opisywania firmy pochodzącej od użytkownika zewnętrznego. Maksymalna długość nazwy firmy wynosi 64 znaki.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ConsentProvidedForMinor
Określa, czy zgoda została uzyskana dla osób nieletnich. Dozwolone wartości: null, granteddenied i notRequired. Aby uzyskać więcej informacji, zapoznaj się z [legalnymi definicjami właściwości grupy wiekowej][Dowiedz się więcej o grupach wiekowych i drobnych definicjach zgody].
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Country
Określa kraj lub region użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-CreationType
Wskazuje, czy konto użytkownika jest kontem lokalnym dzierżawy usługi Azure Active Directory B2C. Możliwe wartości to "LocalAccount" i null. Podczas tworzenia konta lokalnego właściwość jest wymagana i musisz ustawić ją na "LocalAccount". Podczas tworzenia konta służbowego nie należy określać właściwości ani ustawiać jej na wartość null.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Department
Określa dział użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayName
Określa nazwę wyświetlaną użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ExtensionProperty
Dodawanie danych do niestandardowych właściwości użytkownika jako podstawowych rozszerzeń otwartych lub bardziej wszechstronnych rozszerzeń schematu. Zobacz [więcej o rozszerzeniach][Dowiedz się więcej o rozszerzeniach].
| Typ: | Dictionary<TKey,TValue>[System.String,System.String] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-FacsimileTelephoneNumber
Numer faksu użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-GivenName
Określa nazwę użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ImmutableId
Ta właściwość służy do kojarzenia lokalnego konta użytkownika usługi Active Directory z obiektem użytkownika usługi Azure AD. Tę właściwość należy określić podczas tworzenia nowego konta użytkownika w grafie, jeśli używasz domeny federacyjnej dla właściwości użytkownika userPrincipalName (UPN).
Ważne: Znaków $ i _ nie można używać podczas określania tej właściwości.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-IsCompromised
Prawda, jeśli naruszono bezpieczeństwo tego użytkownika
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobTitle
Określa stanowisko użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-MailNickName
Określa pseudonim dla adresu e-mail użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Mobile
Określa numer telefonu komórkowego użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ObjectId
Określa identyfikator użytkownika (jako nazwę UPN lub ObjectId) w usłudze Azure AD.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-OtherMails
Określa inne adresy e-mail użytkownika.
| Typ: | List<T>[String] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PasswordPolicies
Określa zasady haseł dla użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PasswordProfile
Określa profil hasła użytkownika.
| Typ: | PasswordProfile |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PhysicalDeliveryOfficeName
Lokalizacja biura w miejscu działalności użytkownika. Maksymalna długość to 128 znaków.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PostalCode
Określa kod pocztowy użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PreferredLanguage
Określa preferowany język użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ShowInAddressList
Ustaw wartość True, aby pokazać tego użytkownika na liście adresowej.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SignInNames
Lista nazw logowania dla tego użytkownika
| Typ: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-State
Określa stan użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-StreetAddress
Określa adres ulicy użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Surname
Określa nazwisko użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-TelephoneNumber
Określa numer telefonu użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UsageLocation
Dwuliterowy kod kraju lub regionu (standard ISO 3166). Wymagane dla użytkowników, którzy mają przypisane licencje ze względu na wymaganie prawne, aby sprawdzić dostępność usług w krajach i regionach. Przykłady to: "US", "JP" i "GB". Nie dopuszcza wartości null.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserPrincipalName
Określa główną nazwę użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserState
W przypadku użytkownika zewnętrznego zaproszonego do dzierżawy przy użyciu interfejsu API zaproszenia ta właściwość reprezentuje stan zaproszenia zaproszonego użytkownika. W przypadku zaproszonych użytkowników stan może mieć PendingAcceptance wartość lub Acceptedlub null dla wszystkich innych użytkowników.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserStateChangedOn
Pokazuje znacznik czasu dla najnowszej zmiany właściwości externalUserState.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserType
Wartość ciągu, która może służyć do klasyfikowania typów użytkowników w katalogu, takich jak "Członek" i "Gość".
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Uwagi
Zobacz przewodnik migracji dla polecenia Set-AzureADUser do programu Microsoft Graph PowerShell.