New-MsolUser
將使用者建立至 Azure Active Directory。
Syntax
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
指定使用者的替代電子郵件地址。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AlternateMobilePhones
指定使用者的替代行動電話號碼。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-BlockCredential
指定使用者是否無法使用其使用者識別碼登入。
Type: | Boolean |
Position: | Named |
Default value: | $false |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-City
指定使用者的城市。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Country
指定使用者的國家或地區。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Department
指定使用者的部門。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayName
指定使用者的顯示名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Fax
指定使用者的傳真編號。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FirstName
指定使用者的名字。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ForceChangePassword
指出下次登入時,使用者必須變更其密碼。
Type: | Boolean |
Position: | Named |
Default value: | $true |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImmutableId
指定使用者同盟身分識別的不彈性識別碼。 對於具有標準身分識別的使用者,應該省略此專案。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LastName
指定使用者的姓氏。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LastPasswordChangeTimestamp
指定上次變更密碼的時間。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LicenseAssignment
指定要指派使用者的授權陣列。
注意
-LicenseAssignment參數已被取代。 瞭解如何使用 Microsoft Graph PowerShell 指派授權。 如需詳細資訊,請參閱 指派授權 Microsoft Graph API。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LicenseOptions
指定授權指派的選項。 用來選擇性地停用 SKU 內的個別服務方案。
Type: | LicenseOption[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MobilePhone
指定使用者的行動電話。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Office
指定使用者的辦公室。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
指定使用者的新密碼。 如果使用者設定為需要強式密碼,則必須符合下列所有規則:
- 密碼必須至少包含一個小寫字母
- 密碼必須至少包含一個大寫字母
- 密碼必須至少包含一個非英數位元
- 密碼不能包含任何空格、索引標籤或分行符號
- 密碼長度必須是 8-16 個字元
- 使用者名稱不能包含在密碼中
如果省略此值,則會將隨機密碼指派給使用者。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PasswordNeverExpires
指定使用者密碼是否定期到期。
Type: | Boolean |
Position: | Named |
Default value: | $false |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PhoneNumber
指定使用者的電話號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PostalCode
指定使用者的郵遞區號。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PreferredDataLocation
指定使用者的慣用資料位置。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PreferredLanguage
指定使用者的慣用語言。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftDeletionTimestamp
指定虛刪除的時間。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-State
指定使用者所在的州或省。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StreetAddress
指定使用者的街道位址。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StrongAuthenticationMethods
指定強式驗證方法的陣列。
Type: | StrongAuthenticationMethod[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StrongAuthenticationRequirements
指定強式驗證需求的陣列。
Type: | StrongAuthenticationRequirement[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StrongPasswordRequired
指定是否需要使用者的強式密碼。
Type: | Boolean |
Position: | Named |
Default value: | $true |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StsRefreshTokensValidFrom
指定 StsRefreshTokensValidFrom 值。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TenantId
指定要執行作業之租使用者的唯一識別碼。 預設值是目前使用者的租使用者。 此參數僅適用于合作夥伴使用者。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Title
指定使用者的標題。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UsageLocation
指定取用服務的使用者位置。 指定兩個字母的國家或地區代碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserPrincipalName
指定此使用者的使用者識別碼。 這是必填欄位。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserType
指定使用者類型。
Type: | UserType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸出
Microsoft.Online.Administration.User
此 Cmdlet 會傳回已建立之新使用者的詳細資料,包括其暫時密碼。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應