Update-AzADUser

Składnia

UPNOrObjectIdParameterSet (domyślnie)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Przykłady

Przykład 1. Aktualizowanie użytkownika według głównej nazwy użytkownika

Update-AzADUser -UPNOrObjectId $upn -City $city

Parametry

-AccountEnabled

wartość true dla włączenia konta; w przeciwnym razie, fałsz. Zawsze wartość true w połączeniu z -Password. -AccountEnabled $false jest ignorowany podczas zmieniania hasła konta.

Właściwości parametru

Zestawy parametrów

-AgeGroup

Ustawia grupę wiekowa użytkownika. Dozwolone wartości: null, minor, notAdult i adult. Aby uzyskać więcej informacji, zapoznaj się z definicjami właściwości grupy wiekowej. Obsługuje $filter (eq, ne, NOT i in).

Właściwości parametru

Zestawy parametrów

-City

Miasto, w którym znajduje się użytkownik. Maksymalna długość to 128 znaków. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-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 to 64 znaki. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Zestawy parametrów

-ConsentProvidedForMinor

Określa, czy zgoda została uzyskana dla osób niepełnoletnich. Dozwolone wartości: null, przyznane, odrzucone i niewymagane. Aby uzyskać więcej informacji, zapoznaj się z definicjami właściwości grupy wiekowej. Obsługuje $filter (eq, ne, NOT i in).

Właściwości parametru

Zestawy parametrów

-Country

Kraj/region, w którym znajduje się użytkownik; na przykład Stany Zjednoczone lub Zjednoczone Królestwo. Maksymalna długość to 128 znaków. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Zestawy parametrów

-DeletedDateTime

.

Właściwości parametru

Zestawy parametrów

-Department

Nazwa działu, w którym działa użytkownik. Maksymalna długość to 64 znaki. Obsługuje $filter (eq, ne, NOT , ge, le i w operatorach).

Właściwości parametru

Zestawy parametrów

-DisplayName

Nazwa wyświetlana w książce adresowej użytkownika. Ta wartość jest zwykle kombinacją imienia i nazwiska użytkownika, środkowego początkowego i nazwiska. Ta właściwość jest wymagana podczas tworzenia użytkownika i nie można jej wyczyścić podczas aktualizacji. Maksymalna długość to 256 znaków. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy i $search.

Właściwości parametru

Zestawy parametrów

-EmployeeHireDate

Data i godzina, kiedy użytkownik został zatrudniony lub rozpocznie pracę w przypadku przyszłego zatrudnienia. Obsługuje $filter (eq, ne, NOT , ge, le, in).

Właściwości parametru

Zestawy parametrów

-EmployeeId

Identyfikator pracownika przypisany do użytkownika przez organizację. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-EmployeeType

Przechwytuje typ procesu roboczego przedsiębiorstwa. Na przykład pracownik, wykonawca, konsultant lub dostawca. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-ExternalUserState

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ć wartość PendingAcceptance lub Accepted lub null dla wszystkich innych użytkowników. Obsługuje $filter (eq, ne, NOT , in).

Właściwości parametru

Zestawy parametrów

-ExternalUserStateChangeDateTime

Przedstawia znacznik czasu dla najnowszej zmiany właściwości externalUserState. Obsługuje $filter (eq, ne, NOT , in).

Właściwości parametru

Zestawy parametrów

-FaxNumber

Numer faksu użytkownika. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-ForceChangePasswordNextLogin

Należy określić, czy użytkownik musi zmienić hasło podczas następnego pomyślnego logowania (true). Domyślne zachowanie to (fałsz), aby nie zmieniać hasła podczas następnego pomyślnego logowania.

Właściwości parametru

Zestawy parametrów

-GivenName

Podana nazwa (imię) użytkownika. Maksymalna długość to 64 znaki. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-Id

Tylko do odczytu.

Właściwości parametru

Zestawy parametrów

-Identity

Reprezentuje tożsamości, których można użyć do logowania się do tego konta użytkownika. Tożsamość może być dostarczana przez firmę Microsoft (znaną również jako konto lokalne), przez organizacje lub dostawców tożsamości społecznościowych, takich jak Facebook, Google i Microsoft, i powiązanych z kontem użytkownika. Może zawierać wiele elementów o tej samej wartości signInType. Obsługuje $filter (eq), tylko wtedy, gdy parametr signInType nie jest userPrincipalName. Aby skonstruować, zobacz sekcję UWAGI dla właściwości TOŻSAMOŚCI i utwórz tabelę skrótów.

Właściwości parametru

Zestawy parametrów

-InputObject

obiekt wejściowy użytkownika

Właściwości parametru

Zestawy parametrów

-IsResourceAccount

Nie używaj — zarezerwowane do użytku w przyszłości.

Właściwości parametru

Zestawy parametrów

-JobTitle

Stanowisko użytkownika. Maksymalna długość to 128 znaków. Obsługuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-Mail

Adres SMTP użytkownika, na przykład admin@contoso.com. Zmiany tej właściwości spowodują również zaktualizowanie kolekcji proxyAddresses użytkownika w celu uwzględnienia wartości jako adresu SMTP. Chociaż ta właściwość może zawierać znaki wyróżniające, użycie ich może powodować problemy z dostępem do innych aplikacji firmy Microsoft dla użytkownika. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Właściwości parametru

Zestawy parametrów

-MailNickname

Alias poczty dla użytkownika. Ta właściwość musi być określona podczas tworzenia użytkownika. Maksymalna długość to 64 znaki. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-ObjectId

Główna nazwa użytkownika, który ma zostać zaktualizowany.

Właściwości parametru

Zestawy parametrów

-OfficeLocation

Lokalizacja biura w miejscu działalności użytkownika. Maksymalna długość to 128 znaków. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-OnPremisesImmutableId

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 userPrincipalName (UPN) użytkownika. UWAGA: nie można używać znaków $ i _ podczas określania tej właściwości. Zwrócone tylko w $select. Obsługuje $filter (eq, ne, NOT, ge, le, in)..

Właściwości parametru

Zestawy parametrów

-OtherMail

Lista dodatkowych adresów e-mail użytkownika; na przykład: ['bob@contoso.com', 'Robert@fabrikam.com']. UWAGA: Chociaż ta właściwość może zawierać znaki wyróżniające, mogą powodować problemy z dostępem do aplikacji pierwszej firmy dla użytkownika. Obsługuje $filter (eq, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-PassThru

Zwraca wartość true, gdy polecenie powiedzie się

Właściwości parametru

Zestawy parametrów

-Password

Hasło użytkownika. Ta właściwość jest wymagana podczas tworzenia użytkownika.

Można go zaktualizować, ale użytkownik będzie musiał zmienić hasło podczas następnego logowania.

Hasło musi spełniać minimalne wymagania określone przez właściwość passwordPolicies użytkownika. Domyślnie wymagane jest silne hasło. W przypadku zmiany hasła przy użyciu tej metody właściwość AccountEnabled jest ustawiona na wartość true.

Właściwości parametru

Zestawy parametrów

-PasswordPolicy

Określa zasady haseł dla użytkownika. Ta wartość to wyliczenie z jedną możliwą wartością DisableStrongPassword, która umożliwia określenie słabszych haseł niż domyślne zasady. Można również określić wyjątek DisablePasswordExpiration. Te dwa mogą być określone razem; na przykład: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Właściwości parametru

Zestawy parametrów

-PasswordProfile

passwordProfile Aby utworzyć konstrukcję, zobacz sekcję UWAGI dla właściwości PASSWORDPROFILE i utwórz tabelę skrótów.

Właściwości parametru

Zestawy parametrów

-PostalCode

Kod pocztowy adresu pocztowego użytkownika. Kod pocztowy jest specyficzny dla kraju/regionu użytkownika. W Stanach Zjednoczonych Ameryki ten atrybut zawiera kod pocztowy. Maksymalna długość to 40 znaków. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-PreferredLanguage

Preferowany język dla użytkownika. Należy postępować zgodnie z kodem ISO 639-1; na przykład en-US. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-ShowInAddressList

wartość true, jeśli globalna lista adresów programu Outlook powinna zawierać tego użytkownika, w przeciwnym razie wartość false. Jeśli nie zostanie ustawiona, będzie to traktowane jako prawda. W przypadku użytkowników zaproszonych za pośrednictwem menedżera zaproszeń ta właściwość zostanie ustawiona na wartość false. Obsługuje $filter (eq, ne, NOT, in).

Właściwości parametru

Zestawy parametrów

-State

Stan lub prowincja w adresie użytkownika. Maksymalna długość to 128 znaków. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-StreetAddress

Adres ulicy miejsca prowadzenia działalności użytkownika. Maksymalna długość to 1024 znaki. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-Surname

Nazwisko użytkownika (nazwisko lub nazwisko). Maksymalna długość to 64 znaki. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-UPNOrObjectId

Główna nazwa użytkownika lub identyfikator obiektu, który ma zostać zaktualizowany.

Właściwości parametru

Zestawy parametrów

-UsageLocation

Dwuliterowy kod kraju (standard ISO 3166). Wymagane dla użytkowników, którzy mają przypisane licencje ze względu na wymóg prawny sprawdzania dostępności usług w krajach. Przykłady: USA, JP i GB. Nie może być null. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Właściwości parametru

Zestawy parametrów

-UserPrincipalName

Główna nazwa użytkownika (UPN) użytkownika. Nazwa UPN to nazwa logowania w stylu internetowym dla użytkownika oparta na standardzie internetowym RFC 822. Zgodnie z konwencją powinno to być mapowane na nazwę e-mail użytkownika. Ogólny format to alias@domain, gdzie domena musi znajdować się w kolekcji zweryfikowanych domen dzierżawy. Ta właściwość jest wymagana podczas tworzenia użytkownika. Zweryfikowane domeny dzierżawy można uzyskać z właściwości verifiedDomains organizacji. UWAGA: Chociaż ta właściwość może zawierać znaki wyróżniające, mogą powodować problemy z dostępem do aplikacji pierwszej firmy dla użytkownika. Obsługuje $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) i $orderBy.

Właściwości parametru

Zestawy parametrów

-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ść. Obsługuje $filter (eq, ne, NOT, in,).

Właściwości parametru

Zestawy parametrów

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

IMicrosoftGraphUser

Dane wyjściowe

Boolean

Uwagi