New-AzureADUser
Azure AD ユーザーを作成します。
構文
New-AzureADUser
[-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>]
説明
New-AzureADUser コマンドレットは、Azure Active Directory (Azure AD) にユーザーを作成します。
例
例 1: ユーザーを作成する
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user NewUser@contoso.com Member
このコマンドにより、新しいユーザーが作成されます。
パラメーター
-AccountEnabled
ユーザーのアカウントが有効かどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AgeGroup
これは、ユーザーの年齢グループを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-City
ユーザーの市区町村を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CompanyName
これにより、ユーザーの会社名が指定されます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ConsentProvidedForMinor
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Country
ユーザーの国または地域を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CreationType
ユーザー アカウントが Azure Active Directory B2C テナントのローカル アカウントかどうかを示します。
設定可能な値は LocalAccount
および null
です。
ローカル アカウントを作成するときは、 プロパティが必要であり、 に設定する LocalAccount
必要があります。
職場または学校アカウントを作成するときは、 プロパティを指定したり、 に null
設定したりしないでください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Department
ユーザーの部署を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisplayName
ユーザーの表示名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExtensionProperty
型: | Dictionary<TKey,TValue>[System.String,System.String] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FacsimileTelephoneNumber
ユーザーの電話番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GivenName
ユーザーの指定した名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ImmutableId
このプロパティは、オンプレミスの Active Directory ユーザー アカウントを Azure AD ユーザー オブジェクトと関連付けるために使用されます。 ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用している場合は、Graph で新しいユーザー アカウントを作成するときに、このプロパティを指定する必要があります。
重要: および 文字は$
_
、このプロパティを指定するときに使用できません。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IsCompromised
このユーザーが侵害されているかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobTitle
ユーザーの役職を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MailNickName
ユーザーのメール のニックネームを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Mobile
ユーザーの携帯電話番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OtherMails
ユーザーのその他の電子メール アドレスの一覧。 たとえば、bob@contoso.com
、Robert@fabrikam.com
のようになります。
型: | List<T>[String] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PasswordPolicies
ユーザーのパスワード ポリシーを指定します。
この値は、1 つの可能な値が である DisableStrongPassword
列挙です。これにより、既定のポリシーよりも弱いパスワードを指定できます。
DisablePasswordExpiration
を指定することもできます。
2 つを一緒に指定することができます。例: "DisablePasswordExpiration, DisableStrongPassword"
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PasswordProfile
ユーザーのパスワード プロファイルを指定します。
このパラメーターのパラメーター型は であることに PasswordProfile
注意してください。
この型のパラメーターを渡すには、まず が必要です。
- その型を使用して PowerShell で変数を作成します。
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- この変数でパスワードの値を設定します。
$PasswordProfile.Password = "\<Password\>"
- 最後に、この変数を コマンドレットに渡します。
New-AzureADUser -PasswordProfile $PasswordProfile ...
PasswordProfile で設定できるその他の属性は次のとおりです。
-
$PasswordProfile.EnforceChangePasswordPolicy
- このユーザーに対してパスワード変更ポリシーが有効または無効になっていることを示すブール値。 -
$PasswordProfile.ForceChangePasswordNextLogin
- ユーザーが次のサインイン時にパスワードを変更する必要があることを示すブール値。
型: | PasswordProfile |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PhysicalDeliveryOfficeName
ユーザーの物理的な配送オフィス名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PostalCode
ユーザーの郵便番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PreferredLanguage
ユーザーの優先言語を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ShowInAddressList
True の場合は、アドレス一覧にこのユーザーを表示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SignInNames
Azure Active Directory B2C テナントで、ローカル アカウントのサインイン名のコレクションを指定します。
各サインイン名は、企業/テナント全体で一意にする必要があります。 プロパティは、ローカル アカウント ユーザーを作成するときに指定する必要があります。 職場または学校アカウントを作成するときに指定しないでください。
型: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-State
ユーザーの状態を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-StreetAddress
ユーザーの番地を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Surname
ユーザーの姓を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TelephoneNumber
電話番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UsageLocation
2 文字の国または地域コード (ISO 標準 3166)。
法的要件によりライセンスが割り当てられるユーザーは、国と地域でのサービスの可用性を確認する必要があります。
たとえば、、US
JP
、および GB
です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserPrincipalName
ユーザーのプリンシパル名 (UPN) を指定します。
UPN は、インターネット標準 RFC 822 に基づくユーザーのインターネット形式のログイン名です。
慣例により、これはユーザーの電子メール名にマップされる必要があります。
一般的な形式は です alias@domain
。
職場または学校のアカウントの場合、domain がテナントの確認済みドメインのコレクションに存在している必要があります。 このプロパティは職場または学校のアカウントを作成するときに必要です。ローカル アカウントでは省略可能です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserState
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserStateChangedOn
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserType
ディレクトリ内のユーザー タイプを分類するために使用できる文字列値です (例: "Member"、"Guest")。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
メモ
New-AzureADUser の Microsoft Graph PowerShell への移行ガイドを参照してください。