New-EntraUser
Microsoft Entra ID ユーザーを作成します。
構文
Default (既定)
New-EntraUser
-DisplayName <String>
-AccountEnabled <Boolean>
-PasswordProfile <PasswordProfile>
[-City <String>]
[-UserStateChangedOn <String>]
[-CompanyName <String>]
[-PreferredLanguage <String>]
[-FaxNumber <String>]
[-GivenName <String>]
[-Mobile <String>]
[-UsageLocation <String>]
[-PostalCode <String>]
[-AgeGroup <String>]
[-CreationType <String>]
[-ConsentProvidedForMinor <String>]
[-MailNickName <String>]
[-ImmutableId <String>]
[-Country <String>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-Department <String>]
[-PasswordPolicies <String>]
[-JobTitle <String>]
[-UserState <String>]
[-UserType <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-UserPrincipalName <String>]
[-State <String>]
[-StreetAddress <String>]
[-BusinessPhones <String>]
[-Surname <String>]
[-ShowInAddressList <Boolean>]
[<CommonParameters>]
説明
New-EntraUser コマンドレットは、Microsoft Entra IDでユーザーを作成します。 ユーザーを作成する DisplayName、AccountEnabled、および PasswordProfile パラメーターを指定します。
例
例 1: MailNickName パラメーターを使用してユーザーを作成する
Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
DisplayName = 'Avery Iona'
PasswordProfile = $passwordProfile
UserPrincipalName = 'AveryI@contoso.com'
AccountEnabled = $true
MailNickName = 'averyi'
}
New-EntraUser @userParams
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Avery Iona AveryI@contoso.com Member
このコマンドを実行すると、新しいユーザーが作成されます。
例 2: AgeGroup パラメーターを使用してユーザーを作成する
Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
DisplayName = 'Peyton Davis'
PasswordProfile = $passwordProfile
UserPrincipalName = 'PeytonD@contoso.com'
AccountEnabled = $true
MailNickName = 'PeytonD'
AgeGroup = 'adult'
}
New-EntraUser @userParams
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
bbbbbbbb-1111-2222-3333-cccccccccccc Peyton Davis PeytonD@contoso.com Member
このコマンドを実行すると、新しいユーザーが作成されます。
例 3: City パラメーターを使用してユーザーを作成する
Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
DisplayName = 'Blake Martin'
PasswordProfile = $passwordProfile
UserPrincipalName = 'BlakeM@contoso.com'
AccountEnabled = $true
MailNickName = 'BlakeM'
City = 'New York'
}
New-EntraUser @userParams
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
cccccccc-2222-3333-4444-dddddddddddd Blake Martin BlakeM@contoso.com Member
このコマンドを実行すると、新しいユーザーが作成されます。
例 4: Department パラメーターを使用してユーザーを作成する
Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
DisplayName = 'Parker Jones'
PasswordProfile = $passwordProfile
UserPrincipalName = 'ParkerJ@contoso.com'
AccountEnabled = $true
MailNickName = 'ParkerJ'
Department = 'IT'
}
New-EntraUser @userParams
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
dddddddd-3333-4444-5555-eeeeeeeeeeee Parker Jones ParkerJ@contoso.com Member
このコマンドを実行すると、新しいユーザーが作成されます。
例 5: Mobile パラメーターを使用してユーザーを作成する
Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$UserParams = @{
DisplayName = 'Sawyer Miller'
PasswordProfile = $passwordProfile
UserPrincipalName = 'SawyerM@contoso.com'
AccountEnabled = $true
MailNickName = 'SawyerM'
Mobile = '+18989898989'
}
New-EntraUser @UserParams
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
eeeeeeee-4444-5555-6666-ffffffffffff Sawyer Miller SawyerM@contoso.com Member
このコマンドを実行すると、新しいユーザーが作成されます。
パラメーター
-AccountEnabled
ユーザーのアカウントが有効かどうかを示します。
パラメーターのプロパティ
| 型: | System.Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AgeGroup
ユーザーの年齢グループを指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BusinessPhones
電話番号を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 電話番号 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-City
ユーザーの市区町村を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CompanyName
ユーザーの会社名を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
未成年者について同意を得られているかどうかを設定します。
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Country
ユーザーの国を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CreationType
ユーザー アカウントが Microsoft Entra ID B2C テナントのローカル アカウントであるかどうかを示します。
指定できる値は "LocalAccount" と null です。
- ユーザーがローカル アカウントを作成するときは、プロパティが必要であり、"LocalAccount" に設定する必要があります。
- ユーザーが職場または学校アカウントを作成する場合は、プロパティを指定したり、null に設定したりしないでください。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Department
ユーザーの部署を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisplayName
ユーザーの表示名を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FaxNumber
ユーザーの FAX 番号を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ファクシミリ電話番号, FAX |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GivenName
ユーザーの指定した名前を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ImmutableId
このプロパティは、オンプレミスのユーザー アカウントをMicrosoft Entra ID オブジェクトにリンクし、ユーザーの userPrincipalName (UPN) がフェデレーション ドメイン内にある場合にMicrosoft Graphで新しいユーザーを作成するときに必要です。
重要: このプロパティを指定する場合、$ 文字と _ 文字は使用できません。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobTitle
ユーザーの役職を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MailNickName
ユーザーのメール ニックネームを指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Mobile
ユーザーの携帯電話番号を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OtherMails
ユーザーのその他の電子メール アドレスの一覧。例: "bob@contoso.com"、"Robert@fabrikam.com"。
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[System.String]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PasswordPolicies
ユーザーのパスワード ポリシーを指定します。
この値は列挙値であり、可能な 1 つの値は "DisableStrongPassword" です。この場合は、既定のポリシーより弱いパスワードを指定できます。
"DisablePasswordExpiration" を指定することもできます。
これら 2 つを一緒に指定できます。例: "DisablePasswordExpiration, DisableStrongPassword"。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PasswordProfile
ユーザーのパスワード プロファイルを指定します。
このパラメーターのパラメーター型は "PasswordProfile" です。
この型のパラメーターを渡すには、まず、その型を使用して PowerShell で変数を作成する必要があります。
$passwordProfile = New-Object -TypeName Microsoft。Open.AzureAD.Model.PasswordProfile
次に、この変数のパスワードの値の設定に進むことができます。
$passwordProfile.Password = "<Password>"
最後に、この変数をコマンドレットに渡すことができます。
New-EntraUser -PasswordProfile $passwordProfile ...
PasswordProfile で設定できるその他の属性は次のとおりです。
パラメーターのプロパティ
| 型: | PasswordProfile
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PostalCode
ユーザーの郵便番号を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PreferredLanguage
ユーザーの優先言語を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ShowInAddressList
True の場合は、アドレス一覧にこのユーザーを表示します。
パラメーターのプロパティ
| 型: | System.Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SignInNames
Microsoft Entra ID B2C テナント内のローカル アカウントのサインイン名のコレクションを指定します。
各サインイン名は、会社/テナント全体で一意である必要があります。
このプロパティは、ローカル アカウント ユーザーを作成するときに指定する必要があります。職場または学校アカウントを作成するときに指定しないでください。
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-State
ユーザーの状態を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StreetAddress
ユーザーの番地を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Surname
ユーザーの姓を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UsageLocation
2 文字の国コード (ISO 規格 3166)
国でのサービスの可用性を確認するための法的要件により、ライセンスが割り当てられているユーザーに必要です。
たとえば、"US"、"JP"、"GB" などです。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserPrincipalName
ユーザーのユーザー プリンシパル名 (UPN)。
UPN は、インターネット標準 RFC 822 に基づいた、インターネット スタイルのユーザーのサインイン名です。
慣例により、この UPN はユーザーの電子メール名にマップする必要があります。
一般的な形式は "alias@domain" です。
職場または学校アカウントの場合、ドメインはテナントの検証済みドメインのコレクションに存在する必要があります。
このプロパティは、職場または学校アカウントが作成されるときに必要です。ローカル アカウントの場合は省略可能です。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserState
招待 API を使用してテナントに招待された外部ユーザーの場合、このプロパティは招待されたユーザーの招待状態を表します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserStateChangedOn
userState プロパティに対する最新の変更のタイムスタンプを表示します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserType
ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (“Member”、“Guest” など)。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。