New-AzureQuickVM

リファレンス

モジュール:: Azure

Azure 仮想マシンを構成して作成します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

New-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

New-AzureQuickVM コマンドレットは、Azure 仮想マシンを構成して作成します。このコマンドレットは、既存の Azure サービスに仮想マシンをデプロイできます。このコマンドレットは、新しい仮想マシンをホストする Azure サービスを作成することもできます。

例

例 1: 仮想マシンを作成する

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

このコマンドは、既存のサービスで Windows オペレーティングシステムを実行する仮想マシンを作成します。このコマンドレットは、指定されたイメージに仮想マシンを基にします。このコマンドは WaitForBoot パラメーターを指定します。そのため、コマンドレットは仮想マシンの起動を待機します。

例 2: 証明書を使用して仮想マシンを作成する

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

最初のコマンドは、ストアから証明書を取得し、$certs変数に格納します。

2 番目のコマンドは、イメージから既存のサービスで Windows オペレーティングシステムを実行する仮想マシンを作成します。既定では、WinRM Https リスナーは仮想マシンで有効になっています。このコマンドは WaitForBoot パラメーターを指定します。そのため、コマンドレットは仮想マシンの起動を待機します。このコマンドは、WinRM 証明書と X509Certificates をホストされるサービスにアップロードします。

例 3: Linux オペレーティングシステムを実行する仮想マシンを作成する

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

このコマンドは、イメージから Linux オペレーティングシステムを実行する仮想マシンを作成します。このコマンドは、新しい仮想マシンをホストするサービスを作成します。このコマンドは、サービスの場所を指定します。

例 4: 仮想マシンを作成し、新しい仮想マシンをホストするサービスを作成する

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

最初のコマンドは、Get-AzureLocation コマンドレットを使用して場所を取得し、$Locations配列変数に格納します。

2 番目のコマンドは、Get-AzureVMImage コマンドレットを使用して使用可能なイメージを取得し、$Images配列変数に格納します。

最後のコマンドでは、VirtualMachine25 という名前の大規模な仮想マシンを作成します。仮想マシンは、Windows オペレーティングシステムを実行します。これは、$Images内のいずれかの画像に基づいています。このコマンドにより、新しい仮想マシン用に ContosoService03 という名前のサービスが作成されます。サービスは、$Locations内の場所にあります。

例 5: 予約済み IP 名を持つ仮想マシンを作成する

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

最初のコマンドは場所を取得し、$Locations配列変数に格納します。

2 番目のコマンドは、使用可能なイメージを取得し、$Images配列変数に格納します。

最後のコマンドでは、$Imagesのいずれかのイメージに基づいて VirtualMachine27 という名前の仮想マシンを作成します。このコマンドは、$Locations内の場所にサービスを作成します。仮想マシンには予約済みの IP 名があり、以前は $ipName 変数に格納されています。

パラメーター

-AdminUsername

このコマンドレットが仮想マシン上に作成する管理者アカウントのユーザー名を指定します。

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

-AffinityGroup

仮想マシンのアフィニティグループを指定します。このコマンドレットによって仮想マシンの Azure サービスが 作成される場合にのみ、このパラメーターまたは Location パラメーターを指定します。

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

-AvailabilitySetName

このコマンドレットで仮想マシンを作成する可用性セットの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-DisableGuestAgent

このコマンドレットは、サービスとしてのインフラストラクチャ (IaaS) プロビジョニングゲストエージェントを無効にすることを示します。

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

-DnsSettings

新しい展開の DNS 設定を定義する DNS サーバーオブジェクトの配列を指定します。 DnsServer オブジェクトを作成するには、New-AzureDns コマンドレットを使用します。

Type:	DnsServer[]
Position:	Named
Default value:	None
Required:	False
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

-HostCaching

オペレーティングシステムディスクのホストキャッシュモードを指定します。有効な値は次のとおりです。

ReadOnly
ReadWrite

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

-ImageName

このコマンドレットがオペレーティングシステムディスクの作成に使用するディスクイメージの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-InstanceSize

インスタンスのサイズを指定します。有効な値は次のとおりです。

ExtraSmall
Small
Medium
Large
ExtraLarge
A5
A6
A7
A8
A9
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
Standard_D1
Standard_D2
Standard_D3
Standard_D4
Standard_D11
Standard_D12
Standard_D13
Standard_D14

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

-Location

仮想マシンをホストする Azure データセンターを指定します。このパラメーターを指定すると、コマンドレットによって、指定した場所に Azure サービスが作成されます。このパラメーターまたは AffinityGroup パラメーターは、このコマンドレットが仮想マシン用の Azure サービスを作成する場合にのみ指定します。

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

-MediaLocation

このコマンドレットで仮想マシンディスクを作成する Azure Storage の場所を指定します。

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

-Name

このコマンドレットで作成する仮想マシンの名前を指定します。

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

-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

-ReservedIPName

予約済み IP 名を指定します。

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

-ReverseDnsFqdn

逆引き DNS 検索の完全修飾ドメイン名を指定します。

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

-ServiceName

このコマンドレットが新しい仮想マシンを追加する新しい Azure サービスまたは既存の Azure サービスの名前を指定します。

新しいサービスを指定すると、このコマンドレットによって作成されます。新しいサービスを作成するには、Location または AffinityGroup パラメーターを指定する必要があります。

既存のサービスを指定する場合は、Location または AffinityGroup を指定しないでください。

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-SubnetNames

仮想マシンのサブネット名の配列を指定します。

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

-VNetName

仮想マシンの仮想ネットワークの名前を指定します。

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

-WaitForBoot

このコマンドレットは、仮想マシンが ReadyRole 状態になるまで待機することを示します。仮想マシンが次のいずれかの状態に達すると、コマンドレットは失敗します:FailedStartingVM、ProvisioningFailed、または ProvisioningTimeout。

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

-Windows

このコマンドレットによって 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

Share via