New-AzureQuickVM

リファレンス

モジュール:: Azure

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。詳細については、「Azure Service Manager の廃止」を参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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

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

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

-AffinityGroup

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

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

-AvailabilitySetName

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

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

-Certificates

このコマンドレットがサービスの作成に使用する証明書の一覧を指定します。

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

-CustomDataFile

仮想マシンのデータファイルを指定します。このコマンドレットは、ファイルの内容を Base64 としてエンコードします。ファイルの長さは 64 KB 未満である必要があります。

ゲストオペレーティングシステムが Windows オペレーティングシステムの場合、このコマンドレットは、%SYSTEMDRIVE%\AzureData\CustomData.bin という名前のバイナリファイルとしてこのデータを保存します。

ゲストオペレーティングシステムが Linux の場合、このコマンドレットはovf-env.xml ファイルを使用してデータを渡します。インストールによって、そのファイルが /var/lib/waagent ディレクトリにコピーされます。エージェントは、Base64 でエンコードされたデータも /var/lib/waagent/CustomData に格納します。

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

-DisableGuestAgent

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

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

-DisableWinRMHttps

このコマンドレットが HTTPS で Windows リモート管理 (WinRM) を無効にすることを示します。既定では、WinRM は HTTPS 経由で有効になっています。

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

-DnsSettings

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

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

-EnableWinRMHttp

このコマンドレットが HTTP 経由で WinRM を有効にすることを示します。

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

-HostCaching

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

ReadOnly
ReadWrite

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

-ImageName

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

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

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

続行
Ignore
Inquire
SilentlyContinue
阻止
[中断]

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

-InformationVariable

情報変数を指定します。

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

-InstanceSize

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

ExtraSmall
Small
中
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

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

-Linux

このコマンドレットによって Linux ベースの仮想マシンが作成されることを示します。

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

-LinuxUser

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

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

-Location

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

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

-MediaLocation

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

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

-Name

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

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

-NoExportPrivateKey

この構成で秘密キーがアップロードされないことを示します。

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

-NoWinRMEndpoint

このコマンドレットが仮想マシンの WinRM エンドポイントを追加しないことを示します。

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

-Password

管理アカウントのパスワードを指定します。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

-ReservedIPName

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

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

-ReverseDnsFqdn

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

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

-ServiceName

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

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

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

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

-SSHKeyPairs

SSH キーペアを指定します。

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

-SSHPublicKeys

SSH 公開キーを指定します。

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

-SubnetNames

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

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

-VNetName

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

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

-WaitForBoot

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

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

-Windows

このコマンドレットによって Windows 仮想マシンが作成されることを示します。

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

-WinRMCertificate

このコマンドレットが WinRM エンドポイントに関連付ける証明書を指定します。

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

-X509Certificates

ホストされるサービスに展開される X509 証明書の配列を指定します。

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

次の方法で共有