Set-AzureADUser

Aktualizacje 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.Displayname

Przykł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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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].

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Określa miasto użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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].

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Określa kraj lub region użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Określa dział użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Określa nazwę wyświetlaną użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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].

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

Numer faksu użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Określa nazwę użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutableId

Ta właściwość służy do kojarzenia konta użytkownika lokalna usługa Active Directory z obiektem użytkownika 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Prawda, jeśli naruszono bezpieczeństwo tego użytkownika

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Określa stanowisko użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Określa pseudonim dla adresu e-mail użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Określa numer telefonu komórkowego użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Określa identyfikator użytkownika (jako upN lub ObjectId) w Azure AD.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OtherMails

Określa inne adresy e-mail użytkownika.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicies

Określa zasady haseł dla użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordProfile

Określa profil hasła użytkownika.

Type:PasswordProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

Lokalizacja biura w miejscu działalności użytkownika. Maksymalna długość to 128 znaków.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Określa kod pocztowy użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Określa preferowany język użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

Ustaw wartość True, aby pokazać tego użytkownika na liście adresowej.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SignInNames

Lista nazw logowania dla tego użytkownika

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Określa stan użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Określa adres ulicy użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Określa nazwisko użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Określa numer telefonu użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Określa główną nazwę użytkownika.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Pokazuje znacznik czasu dla najnowszej zmiany właściwości externalUserState.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ść".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Uwagi

Zobacz przewodnik migracji dla polecenia Set-AzureADUser do programu Microsoft Graph PowerShell.