Set-AzureADUser

模組:

AzureAD

更新使用者。

語法

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

Description

Set-AzureADUser Cmdlet 會更新 Azure Active Directory (AD) 中的使用者。

範例

範例 1：更新使用者

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

範例 2：將所有但指定的用戶設定為具有家長同意的未成年人

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

此命令會更新指定的用戶屬性。

參數

-AccountEnabled

指出此帳戶是否啟用。

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

-AgeGroup

由企業應用程式用來判斷使用者的法律年齡群組。 此屬性是只讀屬性，並根據 ageGroup 和 consentProvidedForMinor 屬性計算。 允許的值：null、 minornotAdult 與 adult。 請參閱 [法律年齡群組屬性定義][深入瞭解年齡群組和次要同意定義]。

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

-City

指定使用者的城市。

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

-CompanyName

使用者相關聯的公司名稱。 此屬性可用於描述外部用戶來自的公司。 公司名稱的最大長度為64個字元。

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

-ConsentProvidedForMinor

設定是否已取得未成年人的同意。 允許的值：null、 granteddenied 與 notRequired。 如需詳細資訊，請參閱 [法律年齡群組屬性定義][深入瞭解年齡群組和次要同意定義]。

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

-Country

指定用戶的國家或地區。

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

-CreationType

指定使用者帳戶是否為 Azure Active Directory B2C 租用戶的本機帳戶。 可能的值為 "LocalAccount" 和 null。 建立本機帳戶時，需要此屬性，而且您必須將它設為 "LocalAccount"。 建立工作或學校帳戶時，請勿指定此屬性，或將它設為 null。

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

-Department

指定用戶的部門。

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

-DisplayName

指定用戶的顯示名稱。

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

-ExtensionProperty

將數據新增至自定義使用者屬性做為基本 開啟延伸 模組或更多功能 的架構 extensaions。 請參閱 [深入瞭解擴充功能][深入瞭解擴充功能]。

類型:	Dictionary<TKey,TValue>[System.String,System.String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FacsimileTelephoneNumber

用戶的傳真編號。

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

-GivenName

指定使用者的指定名稱。

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

-ImmutableId

此屬性用來將內部部署 Active Directory 使用者帳戶與其 Azure AD 使用者物件產生關聯。 如果您使用使用者 (UPN) 屬性的同盟網域 userPrincipalName ，則必須在 Graph 中建立新的使用者帳戶時指定這個屬性。 重要：$指定此屬性時，無法使用 和 _ 字元。

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

-IsCompromised

True 是表示 如果此使用者遭到入侵

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

-JobTitle

指定用戶的職稱。

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

-MailNickName

指定使用者郵件地址的暱稱。

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

-Mobile

指定使用者的行動電話號碼。

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

-ObjectId

指定使用者在 Azure AD 中 (為 UPN 或 ObjectId) 的識別碼。

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

-OtherMails

指定使用者的其他電子郵件位址。

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

-PasswordPolicies

指定使用者的密碼原則。

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

-PasswordProfile

指定用戶的密碼設定檔。

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

-PhysicalDeliveryOfficeName

使用者的公司所在位置。 長度上限為 128 個字元。

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

-PostalCode

指定使用者的郵遞區號。

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

-PreferredLanguage

指定使用者的慣用語言。

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

-ShowInAddressList

設定為 True，以在通訊清單中顯示此使用者。

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

-SignInNames

此使用者的登入名稱清單

類型:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-State

指定用戶的狀態。

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

-StreetAddress

指定使用者的街地道址。

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

-Surname

指定使用者的姓氏。

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

-TelephoneNumber

指定用戶的電話號碼。

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

-UsageLocation

ISO 標準 3166) (的兩個字母國家或地區代碼。 由於法律要求檢查國家/地區中服務的可用性，因此需要指派授權的使用者。 範例包括："US"、"JP" 和 "GB" 不可為 Null。

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

-UserPrincipalName

指定使用者的用戶主體名稱。

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

-UserState

對於使用 邀請 API 邀請給租使用者的外部使用者，此屬性代表受邀使用者的邀請狀態。 對於受邀的用戶，狀態可以是 PendingAcceptance 或 Accepted，或是 null 所有其他用戶的狀態。

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

-UserStateChangedOn

顯示 externalUserState 屬性最新變更的時間戳。

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

-UserType

字串值可用來在您的目錄中分類使用者類型，例如 "Member" 和 "Guest"。

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

備註

請參閱 將 Set-AzureADUser 移轉至 Microsoft Graph PowerShell 的移轉指南。

相關連結

• Get-AzureADUser
• New-AzureADUser
• Remove-AzureADUser