共用方式為


New-AzureRmADUser

建立新的 Active Directory 使用者。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

語法

New-AzureRmADUser
   -DisplayName <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-ImmutableId <String>]
   [-MailNickname <String>]
   [-ForceChangePasswordNextLogin]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立新的 Active Directory 使用者(公司/學校帳戶也稱為 org-id)。 如需詳細資訊: https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/users-operations#CreateUser

範例

範例 1 - 建立新的 AD 使用者

PS C:\> $SecureStringPassword = ConvertTo-SecureString -String "password" -AsPlainText -Force
PS C:\> New-AzureRmADUser -DisplayName "MyDisplayName" -UserPrincipalName "myemail@domain.com" -Password $SecureStringPassword -MailNickname "MyMailNickName"

在租使用者中建立名稱為 「MyDisplayName」 和用戶主體名稱 「myemail@domain.com的新 AD 使用者。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

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

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

-DisplayName

要顯示在用戶通訊錄中的名稱。 範例 'Alex Wu'。

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

-ForceChangePasswordNextLogin

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

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

-ImmutableId

只有當您使用同盟網域作為用戶的用戶主體名稱 (upn) 屬性時,才需要指定它。

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

-MailNickname

用戶的郵件別名。

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

-Password

使用者的密碼。 它必須符合租用戶的密碼複雜度需求。 建議設定強密碼。

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

-UserPrincipalName

用戶主體名稱。 Example-''someuser@contoso.com。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

String

SecureString

SwitchParameter

輸出

PSADUser