Add-AzureProvisioningConfig
Azure 仮想マシンのプロビジョニング構成を追加します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-CustomDataFile <String>]
[-Windows]
[-AdminUsername <String>]
[-Password <String>]
[-ResetPasswordOnFirstLogon]
[-DisableAutomaticUpdates]
[-NoRDPEndpoint]
[-TimeZone <String>]
[-Certificates <CertificateSettingList>]
[-EnableWinRMHttp]
[-DisableWinRMHttps]
[-WinRMCertificate <X509Certificate2>]
[-X509Certificates <X509Certificate2[]>]
[-NoExportPrivateKey]
[-NoWinRMEndpoint]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-Linux]
[-LinuxUser <String>]
[-DisableSSH]
[-NoSSHEndpoint]
[-NoSSHPassword]
[-SSHPublicKeys <SSHPublicKeyList>]
[-SSHKeyPairs <SSHKeyPairList>]
[-CustomDataFile <String>]
[-Password <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Add-AzureProvisioningConfig
-VM <IPersistentVM>
[-DisableGuestAgent]
[-CustomDataFile <String>]
-AdminUsername <String>
[-WindowsDomain]
[-Password <String>]
[-ResetPasswordOnFirstLogon]
[-DisableAutomaticUpdates]
[-NoRDPEndpoint]
[-TimeZone <String>]
[-Certificates <CertificateSettingList>]
-JoinDomain <String>
-Domain <String>
-DomainUserName <String>
-DomainPassword <String>
[-MachineObjectOU <String>]
[-EnableWinRMHttp]
[-DisableWinRMHttps]
[-WinRMCertificate <X509Certificate2>]
[-X509Certificates <X509Certificate2[]>]
[-NoExportPrivateKey]
[-NoWinRMEndpoint]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
Add-AzureProvisioningConfig コマンドレットは、プロビジョニング構成情報を Azure 仮想マシンの構成に追加します。 構成オブジェクトを使用して、仮想マシンを作成できます。
このコマンドレットは、スタンドアロンの Windows サーバー、Active Directory ドメインに参加している Windows サーバー、Linux ベースのサーバーなど、さまざまなプロビジョニング構成をサポートしています。
Active Directory ドメインに参加しているサーバーを作成するには、Active Directory ドメインの完全修飾ドメイン名と、仮想マシンをドメインに参加させるアクセス許可を持つユーザーのドメイン資格情報を指定します。
例
例 1: スタンドアロン仮想マシンを作成する
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"
このコマンドは、New-AzureVMConfig コマンドレットを使用して仮想マシン構成オブジェクトを作成します。 コマンドは、パイプライン演算子を使用して、そのオブジェクトを現在のコマンドレットに渡します。 現在のコマンドレットは、Windows オペレーティング システムを実行する仮想マシンのプロビジョニング構成を追加します。 構成には、管理者のユーザー名とパスワードが含まれます。 このコマンドは、仮想マシンを 作成する New-AzureVM コマンドレットに構成を渡します。
例 2: ドメインに参加している仮想マシンを作成する
PS C:\> New-AzureVMConfig -Name "DomainVM" -InstanceSize Small -ImageName "Image09" | Add-AzureProvisioningConfig -WindowsDomain -Password "password" -AdminUsername "AdminMain" -ResetPasswordOnFirstLogon -JoinDomain "contoso.com" -Domain "contoso" -DomainUserName "DomainAdminUser" -DomainPassword "DomainPassword" -MachineObjectOU 'OU=AzureVMs,DC=contoso,DC=com' | New-AzureVM -ServiceName "ContosoService"
このコマンドは、仮想マシン構成オブジェクトを作成し、現在のコマンドレットに渡します。 現在のコマンドレットは、contoso ドメインに参加する仮想マシンのプロビジョニング構成を追加します。 このコマンドには、仮想マシンをドメインに参加させるために必要なユーザー名とパスワードが含まれています。 この構成では、ユーザーが最初のログオン時にユーザー パスワードを変更する必要があります。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
例 3: Linux ベースの仮想マシンを作成する
PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"
このコマンドは、仮想マシン構成オブジェクトを作成し、現在のコマンドレットに渡します。 現在のコマンドレットは、Linux オペレーティング システムを実行する仮想マシンのプロビジョニング構成を追加します。 構成には、ルート ユーザー名とパスワードが含まれます。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
例 4: WinRM の証明書を含む仮想マシンを作成する
PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image11" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
最初のコマンドは、証明書ストアから証明書を取得し、$certs配列変数に格納します。
2 番目のコマンドは、仮想マシン構成オブジェクトを作成し、それを現在のコマンドレットに渡します。 現在のコマンドレットは、WinRM の証明書を含むプロビジョニング構成を追加します。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
例 5: HTTP 経由で WinRM が有効になっている仮想マシンを作成する
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
このコマンドは、仮想マシン構成オブジェクトを作成し、現在のコマンドレットに渡します。 現在のコマンドレットは、HTTP 経由で WinRM が有効になっているプロビジョニング構成を追加します。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
例 6: HTTPS で WinRM が無効になっている仮想マシンを作成する
PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
このコマンドは、仮想マシン構成オブジェクトを作成し、現在のコマンドレットに渡します。 現在のコマンドレットは、HTTPS 経由で WinRM を無効にするプロビジョニング構成を追加します。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
例 7: キーをエクスポートしない仮想マシンを作成する
PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -X509Certificates $certs[0], $certs[1] -NoExportPrivateKey | New-AzureVM -ServiceName "ContosoService" -WaitForBoot
最初のコマンドは、証明書ストアから証明書を取得し、$certs配列変数に格納します。
2 番目のコマンドは、仮想マシン構成オブジェクトを作成し、それを現在のコマンドレットに渡します。 現在のコマンドレットは、証明書を含み、秘密キーをエクスポートしない仮想マシンのプロビジョニング構成を追加します。 このコマンドは、プロビジョニング オブジェクトに基づいて仮想マシンを作成します。
パラメーター
-AdminUsername
この構成が仮想マシン上に作成する管理者アカウントのユーザー名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Certificates
この構成が仮想マシンにインストールする証明書のセットを指定します。
Type: | CertificateSettingList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomDataFile
仮想マシンのデータ ファイルを指定します。 このコマンドレットは、ファイルの内容を Base64 としてエンコードします。 ファイルの長さは 64 KB 未満である必要があります。
ゲスト オペレーティング システムが Windows オペレーティング システムの場合、この構成では、このデータが %SYSTEMDRIVE%\AzureData\CustomData.bin という名前のバイナリ ファイルとして保存されます。
ゲスト オペレーティング システムが Linux の場合、この構成では ovf-env.xml ファイルを使用してデータが渡されます。 構成では、そのファイルが /var/lib/waagent ディレクトリにコピーされます。 エージェントは、Base64 でエンコードされたデータも /var/lib/waagent/CustomData に格納します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutomaticUpdates
この構成で自動更新が無効であることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableGuestAgent
この構成により、サービスとしてのインフラストラクチャ (IaaS) ゲスト エージェントが無効になります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableSSH
この構成で SSH が無効であることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWinRMHttps
この構成で HTTPS の Windows リモート管理 (WinRM) が無効であることを示します。 既定では、WinRM は HTTPS 経由で有効になっています。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Domain
コンピューターをドメインに追加するアクセス許可を持つアカウントのドメインの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainPassword
コンピューターをドメインに追加するアクセス許可を持つユーザー アカウントのパスワードを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainUserName
コンピューターをドメインに追加するアクセス許可を持つユーザー アカウントの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableWinRMHttp
この構成で HTTP 経由の WinRM が有効であることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JoinDomain
参加するドメインの完全修飾ドメイン名 (FQDN) を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Linux
この構成によって Linux 構成が作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinuxUser
この構成が仮想マシン上に作成する Linux 管理アカウントのユーザー名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MachineObjectOU
構成でコンピューター アカウントを作成する組織単位 (OU) の完全修飾名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoExportPrivateKey
この構成で秘密キーがアップロードされないことを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoRDPEndpoint
この構成により、リモート デスクトップ エンドポイントのない仮想マシンが作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoSSHEndpoint
この構成により、SSH エンドポイントなしで仮想マシンが作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoSSHPassword
この構成により、SSH パスワードなしで仮想マシンが作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWinRMEndpoint
この構成では、仮想マシンの WinRM エンドポイントが追加されないことを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
管理者アカウントのパスワードを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResetPasswordOnFirstLogon
仮想マシンで、ユーザーが最初のログオン時にパスワードを変更する必要があることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSHKeyPairs
SSH キー ペアを指定します。
Type: | SSHKeyPairList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSHPublicKeys
SSH 公開キーを指定します。
Type: | SSHPublicKeyList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeZone
仮想マシンのタイム ゾーン (太平洋標準時、カナダ中部標準時など) を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
仮想マシン オブジェクトを指定します。
Type: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Windows
この構成により、Windows オペレーティング システムを実行するスタンドアロン仮想マシンが作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WindowsDomain
この構成により、Active Directory ドメインに参加している Windows サーバーが作成されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WinRMCertificate
この構成が WinRM エンドポイントに関連付ける証明書を指定します。
Type: | X509Certificate2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-X509Certificates
ホストされるサービスに展開される X509 証明書の配列を指定します。
Type: | X509Certificate2[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |