Update-AzADUser

參考

模組:: Az.Resources

更新使用者中的實體

語法

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

更新使用者中的實體

範例

範例 1：依用戶主體名稱更新使用者

Update-AzADUser -UPNOrObjectId $upn -City $city

依用戶主體名稱更新使用者

參數

-AccountEnabled

true 表示啟用帳戶;否則為 false。與 -Password結合時，一律為 true。變更帳戶的密碼時，會忽略 -AccountEnabled $false。

類型:	Boolean
別名:	EnableAccount
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AgeGroup

設定用戶的年齡群組。允許的值：null、minor、notAdult 和成人。如需進一步資訊，請參閱法律年齡群組屬性定義。支援$filter（eq、ne、NOT 和 in）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-City

使用者所在的城市。長度上限為 128 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CompanyName

使用者相關聯的公司名稱。此屬性對於描述外部使用者所來自的公司很有用。公司名稱的最大長度為64個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ConsentProvidedForMinor

設定是否已為未成年人取得同意。允許的值：Null、授與、拒絕和 notRequired。如需進一步資訊，請參閱法律年齡群組屬性定義。支援$filter（eq、ne、NOT 和 in）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Country

使用者所在的國家/地區;例如，美國或英國。長度上限為 128 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	PSObject
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeletedDateTime

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Department

用戶運作所在的部門名稱。最大長度為64個字元。支援$filter（eq、ne、NOT、ge、le 和 in 運算符）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

使用者通訊錄中顯示的名稱。此值通常是使用者名字、中間縮寫和姓氏的組合。建立使用者且無法在更新期間清除時，需要這個屬性。長度上限為 256 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）、$orderBy和$search。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EmployeeHireDate

僱用使用者的日期和時間，或將在未來的僱用時開始工作。支援$filter （eq， ne， NOT ， ge， le， in）。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EmployeeId

由組織指派給使用者的員工標識碼。支援$filter （eq， ne， NOT ， ge， le， in， startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EmployeeType

擷取企業背景工作角色類型。例如，員工、承包商、顧問或廠商。支援$filter （eq， ne， NOT ， ge， le， in， startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExternalUserState

對於使用邀請 API 邀請給租使用者的外部使用者，此屬性代表受邀使用者的邀請狀態。對於受邀的用戶，狀態可以是PendingAcceptance或 Accepted，或所有其他使用者的 Null。支援 $filter （eq， ne， NOT ， in）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExternalUserStateChangeDateTime

顯示 externalUserState 屬性最新變更的時間戳。支援 $filter （eq， ne， NOT ， in）。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FaxNumber

用戶的傳真編號。支援$filter （eq， ne， NOT ， ge， le， in， startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceChangePasswordNextLogin

如果用戶必須在下一次成功登入時變更密碼，則必須指定它（true）。默認行為為 [false] ，無法變更下一次成功登入的密碼。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GivenName

使用者的指定名稱（名字）。最大長度為64個字元。支援$filter （eq， ne， NOT ， ge， le， in， startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

唯讀的。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Identity

表示可用來登入此用戶帳戶的身分識別。身分識別可以由Microsoft（也稱為本機帳戶）、組織或社交識別提供者提供，例如Facebook、Google和 Microsoft，並系結至用戶帳戶。可能包含多個具有相同 signInType 值的專案。僅支援 signInType 不是 userPrincipalName 的 $filter （eq）。若要建構，請參閱 IDENTITY 屬性的 NOTES 一節，並建立哈希表。

類型:	IMicrosoftGraphObjectIdentity[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

使用者輸入物件

類型:	IMicrosoftGraphUser
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-IsResourceAccount

請勿使用 - 保留供日後使用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-JobTitle

用戶的職稱。長度上限為 128 個字元。支援$filter （eq， ne， NOT ， ge， le， in， startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Mail

例如，使用者的 SMTP 位址 admin@contoso.com。此屬性的變更也會更新使用者的 proxyAddresses 集合，以將值納入 SMTP 位址。雖然這個屬性可以包含輔色字元，但使用這些字元可能會對使用者的其他Microsoft應用程式造成存取問題。支援$filter（eq、ne、NOT、ge、le、in、startsWith、endsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MailNickname

用戶的郵件別名。建立使用者時，必須指定這個屬性。最大長度為64個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ObjectId

要更新之用戶的用戶主體名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-OfficeLocation

使用者營業地點中的辦公室位置。長度上限為 128 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OnPremisesImmutableId

這個屬性可用來將內部部署 Active Directory 用戶帳戶與其 Azure AD 使用者對象產生關聯。如果您使用使用者 userPrincipalName （UPN）屬性的同盟網域，則必須在 Graph 中建立新的使用者帳戶時指定此屬性。注意：指定這個屬性時，無法使用 $ 和 _ 字元。只在$select傳回。支援$filter（eq、ne、NOT、ge、le、in）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OtherMail

使用者的其他電子郵件地址清單;例如：['bob@contoso.com'， 'Robert@fabrikam.com']。注意：雖然此屬性可以包含輔色字元，但它們可能會對使用者的第一方應用程式造成存取問題。支援$filter（eq、NOT、ge、le、in、startsWith）。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

當命令成功時傳回 true

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Password

用戶的密碼。建立使用者時需要這個屬性。

它可以更新，但用戶必須變更下一次登入的密碼。

密碼必須符合使用者 passwordPolicies 屬性的 speci./fied 最低需求。根據預設，需要強密碼。使用此方法變更密碼時，AccountEnabled 會設定為 true。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PasswordPolicy

指定用戶的密碼原則。這個值是列舉，其中一個可能值為 DisableStrongPassword，允許比指定預設原則更弱的密碼。您也可以指定 DisablePasswordExpiration。兩者可以一起指定;例如：DisablePasswordExpiration、DisableStrongPassword.Supports $filter （ne， NOT）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PasswordProfile

passwordProfile 若要建構，請參閱 PASSWORDPROFILE 屬性和建立哈希表的 NOTES 一節。

類型:	IMicrosoftGraphPasswordProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PostalCode

用戶郵政地址的郵遞區號。郵遞區編碼專屬於用戶的國家/地區。在美國，此屬性包含郵遞郵遞區號。最大長度為 40 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PreferredLanguage

使用者慣用的語言。應遵循 ISO 639-1 程式代碼;例如，en-US。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ShowInAddressList

如果 Outlook 全域通訊清單應該包含此使用者，則為 true，否則為 false。如果未設定，則會將此視為 true。對於透過邀請管理員邀請的使用者，此屬性會設定為 false。支援 $filter （eq， ne， NOT， in）。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-State

用戶位址中的州或省。長度上限為 128 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StreetAddress

使用者營業地點的街道位址。長度上限為 1024 個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Surname

使用者的姓氏（姓氏或姓氏）。最大長度為64個字元。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UPNOrObjectId

要更新之用戶的用戶主體名稱或物件標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UsageLocation

兩個字母國家/地區代碼（ISO 標準 3166）。由於法律要求檢查國家/地區服務可用性，因此需要指派授權的使用者。範例包括：US、JP 和 GB。不可為 Null。支援$filter（eq、ne、NOT、ge、le、in、startsWith）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserPrincipalName

使用者的使用者主體名稱（UPN）。 UPN 是以因特網標準 RFC 822 為基礎的使用者因特網樣式登入名稱。依照慣例，這應該對應至使用者的電子郵件名稱。一般格式是alias@domain，其中網域必須存在於租使用者的已驗證網域集合中。建立使用者時需要這個屬性。您可以從組織的 verifiedDomains 屬性存取租使用者的已驗證網域。注意：雖然此屬性可以包含輔色字元，但它們可能會對使用者的第一方應用程式造成存取問題。支援$filter（eq、ne、NOT、ge、le、in、startsWith、endsWith）和 $orderBy。

類型:	String
別名:	UPN
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UserType

字串值，可用來分類目錄中的用戶類型，例如 Member 和 Guest。支援$filter （eq， ne， NOT， in， in，）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

IMicrosoftGraphUser

輸出

Boolean

備註

別名

Set-AzADUser

共用方式為