New-MsolUser
Azure Active Directory にユーザーを作成します。
構文
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>] 説明
New-MsolUser コマンドレットは、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.comDavid、優先データの場所が EUR であるユーザーを作成します。
パラメーター
-AlternateEmailAddresses
ユーザーの代替メール アドレスを指定します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-AlternateMobilePhones
ユーザーの代替の携帯電話番号を指定します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-BlockCredential
ユーザーがユーザー ID を使用してログオンできないかどうかを指定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | $false |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-City
ユーザーの市区町村を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Country
ユーザーの国または地域を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Department
ユーザーの部署を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DisplayName
ユーザーの表示名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Fax
ユーザーの FAX 番号を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-FirstName
ユーザーの名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ForceChangePassword
ユーザーが次回サインインする際にパスワードを変更する必要があることを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | $true |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ImmutableId
ユーザーのフェデレーション ID の不変 ID を指定します。 これは、標準 ID を持つユーザーには省略する必要があります。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LastName
ユーザーの姓を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LastPasswordChangeTimestamp
パスワードが最後に変更された時刻を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LicenseAssignment
ユーザーを割り当てるライセンスの配列を指定します。
注意
-LicenseAssignment パラメーターは非推奨です。 Microsoft Graph PowerShell でライセンスを割り当てる方法について説明します。 詳細については、「 ライセンスの割り当て Microsoft Graph API」を参照してください。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-LicenseOptions
ライセンス割り当てのオプションを指定します。 SKU 内の個々のサービス プランを選択的に無効にするために使用されます。
| 型: | LicenseOption[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MobilePhone
ユーザーの携帯電話番号を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Office
ユーザーのオフィスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Password
ユーザーの新しいパスワードを指定します。 強力なパスワードの設定がユーザーに求められる場合、次のルールをすべて満たす必要があります。
- パスワードには、少なくとも 1 つの小文字が含まれている必要があります
- パスワードには、少なくとも 1 つの大文字が含まれている必要があります
- パスワードには、英数字以外の文字が少なくとも 1 文字含まれている必要があります
- パスワードにスペース、タブ、改行を含めることはできません
- パスワードの長さは 8 から 16 文字にする必要があります
- ユーザー名をパスワードに含めることはできません
この値を省略すると、ランダムなパスワードがユーザーに割り当てられます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PasswordNeverExpires
ユーザー パスワードの有効期限を定期的に切れるかどうかを指定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | $false |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PhoneNumber
ユーザーの電話番号を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PostalCode
ユーザーの郵便番号を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PreferredDataLocation
ユーザーの優先データの場所を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PreferredLanguage
ユーザーの優先言語を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SoftDeletionTimestamp
論理的な削除の時刻を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-State
ユーザーが配置されている状態または都道府県を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StreetAddress
ユーザーの番地を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StrongAuthenticationMethods
強力な認証方法の配列を指定します。
| 型: | StrongAuthenticationMethod[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StrongAuthenticationRequirements
強力な認証要件の配列を指定します。
| 型: | StrongAuthenticationRequirement[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StrongPasswordRequired
ユーザーに強力なパスワードを要求するかどうかを指定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | $true |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StsRefreshTokensValidFrom
StsRefreshTokensValidFrom 値を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TenantId
操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Title
ユーザーのタイトルを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-UsageLocation
サービスが使用されるユーザーの場所を指定します。 2 文字の国または地域コードを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-UserPrincipalName
このユーザーのユーザー ID を指定します。 これは必須です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-UserType
ユーザー型を指定します。
| 型: | UserType |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
Microsoft.Online.Administration.User
このコマンドレットは、一時パスワードなど、作成された新しいユーザーに関する詳細を返します。