New-AzureADUser

モジュール:

AzureADPreview

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 (AD) にユーザーを作成します。

例

例 1: ユーザーを作成する

-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

{{ AgeGroup の説明を入力 }}

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-City

ユーザーの市区町村を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CompanyName

{{ CompanyName Description }} を入力します

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

型:	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

@{Text=}

型:	Dictionary<TKey,TValue>[System.String,System.String]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FacsimileTelephoneNumber

{{Fill FacsimileTelephoneNumber Description}}

型:	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

{{ Fill UserState Description }}

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserStateChangedOn

{{ Fill UserStateChangedOn Description }}

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserType

ディレクトリ内のユーザー タイプを分類するために使用できる文字列値です (例: "Member"、"Guest")。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False