New-MsolUser
將使用者建立至 Azure Active Directory。
語法
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Description
New-MsolUser Cmdlet 會在 Azure Active Directory 中建立使用者。 若要讓使用者存取服務，請使用 LicenseAssignment 參數指派授權。
範例
範例 1：建立使用者
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"此命令會建立使用者。 用戶沒有指派任何授權。 系統會為用戶產生隨機密碼。
範例 2：建立使用者並指派授權
注意
-LicenseAssignment 參數已被取代。 瞭解如何使用 Microsoft Graph PowerShell 指派授權。 如需詳細資訊，請參閱 指派授權 Microsoft Graph API。
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"此命令會建立新的使用者並指派授權。
範例 3：建立使用者和慣用的數據位置
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"此命令會建立用戶主體名稱為 jdavidchew@contoso.onmicrosoft.com、顯示名稱為 David，而慣用的數據位置為 EUR。
參數
-AlternateEmailAddresses
指定使用者的替代電子郵件位址。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-AlternateMobilePhones
指定使用者的替代行動電話號碼。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-BlockCredential
指定使用者是否無法使用其使用者識別碼登入。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | $false |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-City
指定使用者的城市。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Country
指定用戶的國家或地區。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Department
指定用戶的部門。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DisplayName
指定用戶的顯示名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Fax
指定用戶的傳真編號。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-FirstName
指定使用者的名字。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ForceChangePassword
指出下次登入時，用戶必須變更其密碼。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | $true |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ImmutableId
指定使用者同盟身分識別的不可變標識碼。 對於具有標準身分識別的使用者，應該省略此專案。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LastName
指定使用者的姓氏。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LastPasswordChangeTimestamp
指定上次變更密碼的時間。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LicenseAssignment
指定要指派用戶的授權陣列。
注意
-LicenseAssignment 參數已被取代。 瞭解如何使用 Microsoft Graph PowerShell 指派授權。 如需詳細資訊，請參閱 指派授權 Microsoft Graph API。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LicenseOptions
指定授權指派的選項。 用來選擇性地停用 SKU 內的個別服務方案。
| 類型: | LicenseOption[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MobilePhone
指定用戶的行動電話。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Office
指定用戶的辦公室。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Password
指定使用者的新密碼。 如果使用者設定為需要強式密碼，則必須符合下列所有規則：
- 密碼必須至少包含一個小寫字母
- 密碼必須至少包含一個大寫字母
- 密碼必須至少包含一個非英數位元
- 密碼不能包含任何空格、索引標籤或換行符
- 密碼長度必須是8-16個字元
- 用戶名稱不能包含在密碼中
如果省略此值，則會將隨機密碼指派給使用者。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PasswordNeverExpires
指定用戶密碼是否定期到期。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | $false |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PhoneNumber
指定用戶的電話號碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PostalCode
指定使用者的郵遞區號。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PreferredDataLocation
指定使用者的慣用資料位置。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PreferredLanguage
指定使用者的慣用語言。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SoftDeletionTimestamp
指定虛刪除的時間。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-State
指定使用者所在的州或省。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StreetAddress
指定使用者的街道位址。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StrongAuthenticationMethods
指定強式驗證方法的陣列。
| 類型: | StrongAuthenticationMethod[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StrongAuthenticationRequirements
指定強式驗證需求的陣列。
| 類型: | StrongAuthenticationRequirement[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StrongPasswordRequired
指定是否需要用戶的強密碼。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | $true |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StsRefreshTokensValidFrom
指定 StsRefreshTokensValidFrom 值。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-TenantId
指定要執行作業之租使用者的唯一標識符。 預設值是目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Title
指定使用者的標題。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-UsageLocation
指定取用服務的使用者位置。 指定兩個字母的國家或地區代碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-UserPrincipalName
指定此使用者的使用者識別碼。 這是必填欄位。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-UserType
指定使用者類型。
| 類型: | UserType |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸出
Microsoft.Online.Administration.User
此 Cmdlet 會傳回已建立之新使用者的詳細數據，包括其暫時密碼。