Update-AzADUser

Modul:

Az.Resources

Aktualizace entity v uživatelích

Syntaxe

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>]

Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Aktualizace entity v uživatelích

Příklady

Příklad 1: Aktualizace uživatele podle hlavního názvu uživatele

Update-AzADUser -UPNOrObjectId $upn -City $city

Aktualizace uživatele podle hlavního názvu uživatele

Parametry

-AccountEnabled

true pro povolení účtu; jinak nepravda. Vždy true při kombinaci s -Password. -AccountEnabled $false se při změně hesla účtu ignoruje.

Typ:	Boolean
Aliasy:	EnableAccount
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AgeGroup

Nastaví věkovou skupinu uživatele. Povolené hodnoty: null, minor, notAdult a adult. Další informace najdete v definicích vlastností věkové skupiny. Podporuje $filter (eq, ne, NOT a in).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-City

Město, ve kterém se nachází uživatel. Maximální délka je 128 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CompanyName

Název společnosti, ke kterému je uživatel přidružený. Tato vlastnost může být užitečná pro popis společnosti, ze které pochází externí uživatel. Maximální délka názvu společnosti je 64 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConsentProvidedForMinor

Nastaví, zda byl udělen souhlas pro podverze. Povolené hodnoty: null, uděleno, odepřeno a notRequired. Další informace najdete v definicích vlastností věkové skupiny. Podporuje $filter (eq, ne, NOT a in).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Country

Země/oblast, ve které se nachází uživatel; například USA nebo Spojené království. Maximální délka je 128 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	PSObject
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DeletedDateTime

.

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Department

Název oddělení, ve kterém uživatel pracuje. Maximální délka je 64 znaků. Podporuje $filter (eq, ne, NOT , ge, le a v operátorech).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisplayName

Jméno zobrazené v adresáři uživatele. Tato hodnota je obvykle kombinací křestního jména uživatele, prostředního iniciály a příjmení. Tato vlastnost se vyžaduje při vytvoření uživatele a během aktualizací ji nelze vymazat. Maximální délka je 256 znaků. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy a $search.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EmployeeHireDate

Datum a čas, kdy byl uživatel přijat nebo začne pracovat v případě budoucího pronájmu. Podporuje $filter (eq, ne, NOT , ge, le, in).

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EmployeeId

Identifikátor zaměstnance přiřazený uživateli organizací. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EmployeeType

Zaznamenává typ podnikového pracovního procesu. Například Zaměstnanec, Dodavatel, Konzultant nebo Dodavatel. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExternalUserState

Pro externího uživatele pozvaný do tenanta pomocí rozhraní API pozvánky představuje tato vlastnost stav pozvánek uživatele. U pozvaných uživatelů může být stav PendingAcceptance nebo Accepted nebo null pro všechny ostatní uživatele. Podporuje $filter (eq, ne, NOT , in).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExternalUserStateChangeDateTime

Zobrazuje časové razítko poslední změny vlastnosti externalUserState. Podporuje $filter (eq, ne, NOT , in).

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FaxNumber

Faxové číslo uživatele. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ForceChangePasswordNextLogin

Musí být zadán, pokud uživatel musí změnit heslo při dalším úspěšném přihlášení (true). Výchozí chování je (nepravda), aby se při příštím úspěšném přihlášení nezměnilo heslo.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-GivenName

Křestní jméno (jméno) uživatele Maximální délka je 64 znaků. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Id

Jen pro čtení.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Identity

Představuje identity, které lze použít k přihlášení k tomuto uživatelskému účtu. Identitu může poskytnout Microsoft (označovaný také jako místní účet), organizace nebo zprostředkovatelé sociálních identit, jako jsou Facebook, Google a Microsoft, a svázané s uživatelským účtem. Může obsahovat více položek se stejnou hodnotou signInType. Podporuje $filter (eq), pouze pokud signInType není userPrincipalName. Pokud chcete vytvořit, přečtěte si část POZNÁMKY o vlastnostech IDENTITY a vytvořte tabulku hash.

Typ:	IMicrosoftGraphObjectIdentity[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

objekt uživatelského vstupu

Typ:	IMicrosoftGraphUser
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-IsResourceAccount

Nepoužívejte – vyhrazeno pro budoucí použití.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobTitle

Pracovní pozice uživatele. Maximální délka je 128 znaků. Podporuje $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Mail

Adresa SMTP pro uživatele, například admin@contoso.com. Změny této vlastnosti také aktualizují kolekci proxyAddresses uživatele tak, aby zahrnovala hodnotu jako adresu SMTP. I když tato vlastnost může obsahovat znaky zvýraznění, jejich použití může způsobit problémy s přístupem k jiným aplikacím Microsoftu pro uživatele. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MailNickname

Alias pošty pro uživatele. Tato vlastnost musí být zadána při vytvoření uživatele. Maximální délka je 64 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ObjectId

Hlavní název uživatele, který se má aktualizovat.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OfficeLocation

Umístění kanceláře v místě podnikání uživatele. Maximální délka je 128 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OnPremisesImmutableId

Tato vlastnost slouží k přidružení místního uživatelského účtu Active Directory k objektu uživatele Azure AD. Tato vlastnost musí být zadána při vytváření nového uživatelského účtu v Graphu, pokud používáte federovanou doménu pro vlastnost userPrincipalName (UPN) uživatele. POZNÁMKA: Při zadávání této vlastnosti nelze použít znaky $ a _. Vráceno pouze v $select. Podporuje $filter (eq, ne, NOT, ge, le, in)..

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OtherMail

Seznam dalších e-mailových adres pro uživatele; Například: ['bob@contoso.com', 'Robert@fabrikam.com']. POZNÁMKA: I když tato vlastnost může obsahovat znaky zvýraznění, mohou způsobit problémy s přístupem k aplikacím první strany pro uživatele. Podporuje $filter (eq, NOT, ge, le, in, startsWith).

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PassThru

Vrátí hodnotu true, když příkaz proběhne úspěšně.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Password

Heslo pro uživatele. Tato vlastnost se vyžaduje při vytvoření uživatele.

Dá se aktualizovat, ale uživatel bude muset změnit heslo při dalším přihlášení.

Heslo musí splňovat minimální požadavky jako speci./fied podle vlastnosti passwordPolicies uživatele. Ve výchozím nastavení se vyžaduje silné heslo. Při změně hesla pomocí této metody je Vlastnost AccountEnabled nastavena na hodnotu true.

Typ:	SecureString
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PasswordPolicy

Určuje zásady hesel pro uživatele. Tato hodnota je výčet s jednou možnou hodnotou DisableStrongPassword, která umožňuje slabší hesla než výchozí zásady zadat. DisablePasswordExpiration lze také zadat. Oba mohou být zadány společně; Například: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PasswordProfile

passwordProfile To construct, see NOTES section for PASSWORDPROFILE properties and create a hash table.

Typ:	IMicrosoftGraphPasswordProfile
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PostalCode

PSČ poštovní adresy uživatele. PSČ je specifické pro zemi nebo oblast uživatele. Tento atribut ve Spojených státech amerických obsahuje PSČ. Maximální délka je 40 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PreferredLanguage

Upřednostňovaný jazyk pro uživatele. Měl by následovat kód ISO 639-1; například en-US. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ShowInAddressList

true pokud globální adresář aplikace Outlook by měl obsahovat tohoto uživatele, jinak false. Pokud není nastavená, bude se považovat za true. Pro uživatele pozvané prostřednictvím správce pozvánek bude tato vlastnost nastavena na false. Podporuje $filter (eq, ne, NOT, in).

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-State

Stát nebo provincie v adrese uživatele. Maximální délka je 128 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StreetAddress

Adresa ulice místa podnikání uživatele. Maximální délka je 1024 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Surname

Příjmení uživatele (příjmení nebo příjmení). Maximální délka je 64 znaků. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UPNOrObjectId

Hlavní název uživatele nebo ID objektu uživatele, který se má aktualizovat.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UsageLocation

Kód země se dvěma písmeny (standard ISO 3166). Vyžaduje se pro uživatele, kteří budou přiřazené licence kvůli právnímu požadavku na kontrolu dostupnosti služeb v zemích. Mezi příklady patří: USA, JP a GB. Nelze použít hodnotu null. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UserPrincipalName

Hlavní název uživatele (UPN) uživatele. Hlavní název uživatele (UPN) je přihlašovací jméno ve stylu internetu pro uživatele založené na internetovém standardu RFC 822. Podle konvence by se to mělo mapovat na e-mailové jméno uživatele. Obecný formát je alias@domain, kde musí být doména přítomna v kolekci ověřených domén tenanta. Tato vlastnost se vyžaduje při vytvoření uživatele. Ověřené domény pro tenanta jsou přístupné z vlastnosti verifiedDomains organizace. POZNÁMKA: I když tato vlastnost může obsahovat znaky zvýraznění, mohou způsobit problémy s přístupem k aplikacím první strany pro uživatele. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) a $orderBy.

Typ:	String
Aliasy:	UPN
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UserType

Řetězcová hodnota, která se dá použít ke klasifikaci typů uživatelů v adresáři, například Člen a Host. Podporuje $filter (eq, ne, NOT, in, ).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

IMicrosoftGraphUser

Výstupy

Boolean

Poznámky

ALIASY

Set-AzADUser