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.comユーザーを作成します。表示名は David で、推奨されるデータの場所は EUR です。

パラメーター

-AlternateEmailAddresses

ユーザーの代替メール アドレスを指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AlternateMobilePhones

ユーザーの別の携帯電話番号を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BlockCredential

ユーザーがユーザー ID を使用してログオンできないかどうかを指定します。

Type:Boolean
Position:Named
Default value:$false
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-City

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Country

ユーザーの国または地域を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Department

ユーザーの部署を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

ユーザーの表示名を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Fax

ユーザーの FAX 番号を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FirstName

ユーザーの名を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceChangePassword

ユーザーが次回サインインする際にパスワードを変更する必要があることを示します。

Type:Boolean
Position:Named
Default value:$true
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImmutableId

ユーザーのフェデレーション ID の不変 ID を指定します。 これは、標準 ID を持つユーザーには省略する必要があります。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LastName

ユーザーの姓を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LastPasswordChangeTimestamp

パスワードが最後に変更された時刻を指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LicenseAssignment

ユーザーを割り当てるライセンスの配列を指定します。

注意

-LicenseAssignment パラメーターは非推奨です。 Microsoft Graph PowerShell でライセンスを割り当てる方法について説明します。 詳細については、「ライセンスの割り当て Microsoft Graph API」を参照してください。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LicenseOptions

ライセンス割り当てのオプションを指定します。 SKU 内の個々のサービス プランを選択的に無効にするために使用されます。

Type:LicenseOption[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MobilePhone

ユーザーの携帯電話番号を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Office

ユーザーのオフィスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Password

ユーザーの新しいパスワードを指定します。 強力なパスワードの設定がユーザーに求められる場合、次のルールをすべて満たす必要があります。

  • パスワードには、少なくとも 1 つの小文字が含まれている必要があります
  • パスワードには、少なくとも 1 つの大文字が含まれている必要があります
  • パスワードには、英数字以外の文字が少なくとも 1 文字含まれている必要があります
  • パスワードにスペース、タブ、または改行を含めることはできません
  • パスワードの長さは 8 から 16 文字にする必要があります
  • ユーザー名をパスワードに含めることはできません

この値を省略すると、ランダムなパスワードがユーザーに割り当てられます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PasswordNeverExpires

ユーザー パスワードの有効期限を定期的に切れるかどうかを指定します。

Type:Boolean
Position:Named
Default value:$false
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PhoneNumber

ユーザーの電話番号を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PostalCode

ユーザーの郵便番号を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PreferredDataLocation

ユーザーの優先データの場所を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PreferredLanguage

ユーザーの優先言語を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SoftDeletionTimestamp

論理的な削除の時間を指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-State

ユーザーが配置されている状態または都道府県を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StreetAddress

ユーザーの番地を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StrongAuthenticationMethods

強力な認証方法の配列を指定します。

Type:StrongAuthenticationMethod[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StrongAuthenticationRequirements

強力な認証要件の配列を指定します。

Type:StrongAuthenticationRequirement[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StrongPasswordRequired

ユーザーに強力なパスワードを要求するかどうかを指定します。

Type:Boolean
Position:Named
Default value:$true
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StsRefreshTokensValidFrom

StsRefreshTokensValidFrom 値を指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Title

ユーザーのタイトルを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UsageLocation

サービスが使用されるユーザーの場所を指定します。 2 文字の国または地域コードを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserPrincipalName

このユーザーのユーザー ID を指定します。 これは必須です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserType

ユーザー型を指定します。

Type:UserType
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

Microsoft.Online.Administration.User

このコマンドレットは、一時パスワードを含め、作成された新しいユーザーの詳細を返します。