New-AzVM

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

注意

これは、以前のバージョンのドキュメントです。 最新の情報については 、最新バージョン を参照してください。

構文

New-AzVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [[-Zone] <String[]>]
   -Name <String>
   -Credential <PSCredential>
   [-NetworkInterfaceDeleteOption <String>]
   [-VirtualNetworkName <String>]
   [-AddressPrefix <String>]
   [-SubnetName <String>]
   [-SubnetAddressPrefix <String>]
   [-PublicIpAddressName <String>]
   [-DomainNameLabel <String>]
   [-AllocationMethod <String>]
   [-SecurityGroupName <String>]
   [-OpenPorts <Int32[]>]
   [-Image <String>]
   [-Size <String>]
   [-AvailabilitySetName <String>]
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-AsJob]
   [-OSDiskDeleteOption <String>]
   [-DataDiskSizeInGb <Int32[]>]
   [-DataDiskDeleteOption <String>]
   [-EnableUltraSSD]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   [-MaxPrice <Double>]
   [-EncryptionAtHost]
   [-HostGroupId <String>]
   [-SshKeyName <String>]
   [-GenerateSshKey]
   [-CapacityReservationGroupId <String>]
   [-UserData <String>]
   [-ImageReferenceId <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzVM
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-EdgeZone <String>]
   [-VM] <PSVirtualMachine>
   [[-Zone] <String[]>]
   [-DisableBginfoExtension]
   [-Tag <Hashtable>]
   [-LicenseType <String>]
   [-AsJob]
   [-OSDiskDeleteOption <String>]
   [-DataDiskDeleteOption <String>]
   [-SshKeyName <String>]
   [-GenerateSshKey]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DisableIntegrityMonitoring]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   -Name <String>
   [-NetworkInterfaceDeleteOption <String>]
   [-VirtualNetworkName <String>]
   [-AddressPrefix <String>]
   [-SubnetName <String>]
   [-SubnetAddressPrefix <String>]
   [-PublicIpAddressName <String>]
   [-DomainNameLabel <String>]
   [-AllocationMethod <String>]
   [-SecurityGroupName <String>]
   [-OpenPorts <Int32[]>]
   -DiskFile <String>
   [-Linux]
   [-Size <String>]
   [-AvailabilitySetName <String>]
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-AsJob]
   [-OSDiskDeleteOption <String>]
   [-DataDiskSizeInGb <Int32[]>]
   [-DataDiskDeleteOption <String>]
   [-EnableUltraSSD]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   [-MaxPrice <Double>]
   [-EncryptionAtHost]
   [-HostGroupId <String>]
   [-CapacityReservationGroupId <String>]
   [-UserData <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzVM コマンドレットは、Azure に仮想マシンを作成します。 このコマンドレットは、仮想マシン オブジェクトを入力として受け取ります。 New-AzVMConfig コマンドレットを使用して、仮想マシン オブジェクトを作成します。 ブート診断用の新しいストレージ アカウントがまだ存在しない場合は、 New-AzVM コマンドレットによって新しいストレージ アカウントが作成されます。 その他のコマンドレットを使用して、Set-AzVMOperatingSystem、Set-AzVMSourceImage、Add-AzVMNetworkInterface、Set-AzVMOSDisk などの仮想マシンを構成できます。 共通 SimpleParameterSet の VM 作成引数を省略可能にすることで、VM を作成するための便利な方法が提供されます。

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

New-AzVM -Name MyVm -Credential (Get-Credential)

VERBOSE: Use 'mstsc /v:myvm-222222.eastus.cloudapp.azure.com' to connect to the VM.

ResourceGroupName        : MyVm
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyVm/provi
ders/Microsoft.Compute/virtualMachines/MyVm
VmId                     : 11111111-1111-1111-1111-111111111111
Name                     : MyVm
Type                     : Microsoft.Compute/virtualMachines
Location                 : eastus
Tags                     : {}
HardwareProfile          : {VmSize}
NetworkProfile           : {NetworkInterfaces}
OSProfile                : {ComputerName, AdminUsername, WindowsConfiguration, Secrets}
ProvisioningState        : Succeeded
StorageProfile           : {ImageReference, OsDisk, DataDisks}
FullyQualifiedDomainName : myvm-222222.eastus.cloudapp.azure.com

このサンプル スクリプトは、仮想マシンを作成する方法を示しています。 スクリプトによって、VM のユーザー名とパスワードが求められます。 このスクリプトでは、他のいくつかのコマンドレットを使用します。

例 2: カスタム ユーザー イメージから仮想マシンを作成する

## VM Account
# Credentials for Local Admin account you created in the sysprepped (generalized) vhd image
$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
## Azure Account
$LocationName = "westus"
$ResourceGroupName = "MyResourceGroup"
# This a Premium_LRS storage account.
# It is required in order to run a client VM with efficiency and high performance.
$StorageAccount = "Mydisk"

## VM
$OSDiskName = "MyClient"
$ComputerName = "MyClientVM"
$OSDiskUri = "https://Mydisk.blob.core.windows.net/disks/MyOSDisk.vhd"
$SourceImageUri = "https://Mydisk.blob.core.windows.net/vhds/MyOSImage.vhd"
$VMName = "MyVM"
# Modern hardware environment with fast disk, high IOPs performance.
# Required to run a client VM with efficiency and performance
$VMSize = "Standard_DS3"
$OSDiskCaching = "ReadWrite"
$OSCreateOption = "FromImage"

## Networking
$DNSNameLabel = "mydnsname" # mydnsname.westus.cloudapp.azure.com
$NetworkName = "MyNet"
$NICName = "MyNIC"
$PublicIPAddressName = "MyPIP"
$SubnetName = "MySubnet"
$SubnetAddressPrefix = "10.0.0.0/24"
$VnetAddressPrefix = "10.0.0.0/16"

$SingleSubnet = New-AzVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$PIP = New-AzPublicIpAddress -Name $PublicIPAddressName -DomainNameLabel $DNSNameLabel -ResourceGroupName $ResourceGroupName -Location $LocationName -AllocationMethod Dynamic
$NIC = New-AzNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id -PublicIpAddressId $PIP.Id

$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $VMSize
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name $OSDiskName -VhdUri $OSDiskUri -SourceImageUri $SourceImageUri -Caching $OSDiskCaching -CreateOption $OSCreateOption -Windows

New-AzVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose

この例では、既存の sys-prepped 一般化されたカスタム オペレーティング システム イメージを取得し、それにデータ ディスクを接続し、新しいネットワークをプロビジョニングして VHD を展開して実行します。 このスクリプトは、ユーザーの操作を必要とする Get-Credential を呼び出す代わりにローカル仮想マシン管理者の資格情報をインラインで使用するため、自動プロビジョニングに使用できます。 このスクリプトは、Azure アカウントに既にログインしていることを前提としています。 Get-AzSubscription コマンドレットを使用して、ログインの状態を確認できます。

例 3: パブリック IP なしで Marketplace イメージから VM を作成する

$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString "password" -AsPlainText -Force
$LocationName = "westus"
$ResourceGroupName = "MyResourceGroup"
$ComputerName = "MyVM"
$VMName = "MyVM"
$VMSize = "Standard_DS3"

$NetworkName = "MyNet"
$NICName = "MyNIC"
$SubnetName = "MySubnet"
$SubnetAddressPrefix = "10.0.0.0/24"
$VnetAddressPrefix = "10.0.0.0/16"

$SingleSubnet = New-AzVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$NIC = New-AzNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id

$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $VMSize
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'WindowsServer' -Skus '2022-datacenter-azure-edition-core' -Version latest

New-AzVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose

このコマンドは、パブリック IP を持たないマーケットプレース イメージから VM を作成します。

例 4: UserData 値を持つ VM を作成する:

## VM Account
$VMLocalAdminUser = "LocalAdminUser";
$VMLocalAdminSecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force;

## Azure Account
$LocationName = "eastus";
$ResourceGroupName = "MyResourceGroup";

# VM Profile & Hardware
$VMName = 'v' + $ResourceGroupName;
$domainNameLabel = "d1" + $ResourceGroupName;
$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

# Create UserData value
$text = "text for UserData";
$bytes = [System.Text.Encoding]::Unicode.GetBytes($text);
$userData = [Convert]::ToBase64String($bytes);

# Create VM
New-AzVM -ResourceGroupName $ResourceGroupName -Name $VMName -Credential $cred -DomainNameLabel $domainNameLabel -UserData $userData;
$vm = Get-AzVM -ResourceGroupName $ResourceGroupName -Name $VMName -UserData;

UserData 値は常に Base64 でエンコードする必要があります。

例 5: 別のリソース グループに既存のサブネットを持つ新しい VM を作成する

$UserName = "User"
$Password = ConvertTo-SecureString "############" -AsPlainText -Force
$psCred = New-Object System.Management.Automation.PSCredential($UserName, $Password)

$Vnet = $(Get-AzVirtualNetwork -ResourceGroupName ResourceGroup2 -Name VnetName)
$PIP = (Get-AzPublicIpAddress -ResourceGroupName ResourceGroup2 -Name PublicIPName)

$NIC = New-AzNetworkInterface -Name NICname -ResourceGroupName ResourceGroup2 -Location SouthCentralUS -SubnetId $Vnet.Subnets[1].Id -PublicIpAddressId $PIP.Id
$VirtualMachine = New-AzVMConfig -VMName VirtualMachineName -VMSize Standard_D4s_v3
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName computerName -Credential $psCred -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'WindowsServer' -Skus '2022-datacenter-azure-edition-core' -Version latest
New-AzVM -ResourceGroupName ResourceGroup1 -Location SouthCentralUS -VM $VirtualMachine

この例では、あるリソース グループ内のマーケットプレースから Windows VM をデプロイし、別のリソース グループに既存のサブネットをデプロイします。

例 6: PlatformFaultDomain 値を持つ VMSS の一部として新しい VM を作成する。

$resourceGroupName= "Resource Group Name"
$domainNameLabel = "Domain Name Label Name"
$vmname = "Virtual Machine Name"
$platformFaultDomainVMDefaultSet = 2
$securePassword = "Password" | ConvertTo-SecureString -AsPlainText -Force
$user = "Username"
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword)
$vmssName = "Vmss Name";

$vmssConfig = New-AzVmssConfig -Location $loc -PlatformFaultDomainCount $vmssFaultDomain;
$vmss = New-AzVmss -ResourceGroupName $resourceGroupName -Name $vmssName -VirtualMachineScaleSet $vmssConfig;

$vm = New-AzVM -ResourceGroupName $resourceGroupName -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -PlatformFaultDomain $platformFaultDomainVMDefaultSet -VmssId $vmss.Id

この例では、PlatformFaultDomain 値を持つ VMSS の一部として新しい VM を作成します。

例 7: 既定でインストールされている GuestAttestation 拡張機能を使用して新しい VM を作成し、DisableIntegrityMonitoring を使用して VM を再作成してこれを回避します。

$rgname = <RESOURCE GROUP NAME>;
$loc = <AZURE REGION>;
New-AzResourceGroup -Name $rgname -Location $loc -Force;

# VM Profile & Hardware
$vmname = 'vm' + $rgname;
$domainNameLabel = "d1" + $rgname;
$vnetname = "myVnet";
$vnetAddress = "10.0.0.0/16";
$subnetname = "slb" + $rgname;
$subnetAddress = "10.0.2.0/24";
$OSDiskName = $vmname + "-osdisk";
$NICName = $vmname+ "-nic";
$NSGName = $vmname + "-NSG";
$OSDiskSizeinGB = 128;
$VMSize = "Standard_DS2_v2";
$PublisherName = "MicrosoftWindowsServer";
$Offer = "WindowsServer";
$SKU = "2019-DATACENTER-GENSECOND";
$securityType = "TrustedLaunch";
$secureboot = $true;
$vtpm = $true;

# Default extension and identity values.
$extDefaultName = "GuestAttestation";
$vmGADefaultIDentity = "SystemAssigned";

# Credential
$password = <PASSWORD>;
$securePassword = $password | ConvertTo-SecureString -AsPlainText -Force;  
$user = <USER NAME>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);

# Network resources
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name $subnetname -AddressPrefix $subnetAddress;
$vnet = New-AzVirtualNetwork -Name $vnetname -ResourceGroupName $rgname -Location $loc -AddressPrefix $vnetAddress -Subnet $frontendSubnet;
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name RDP  -Protocol Tcp  -Direction Inbound -Priority 1001 -SourceAddressPrefix * -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389 -Access Allow;
$nsg = New-AzNetworkSecurityGroup -ResourceGroupName $RGName -Location $loc -Name $NSGName  -SecurityRules $nsgRuleRDP;
$nic = New-AzNetworkInterface -Name $NICName -ResourceGroupName $RGName -Location $loc -SubnetId $vnet.Subnets[0].Id -NetworkSecurityGroupId $nsg.Id -EnableAcceleratedNetworking;

# VM creation
$vmConfig = New-AzVMConfig -VMName $vmName -VMSize $VMSize;
Set-AzVMOperatingSystem -VM $vmConfig -Windows -ComputerName $vmName -Credential $cred;
Set-AzVMSourceImage -VM $vmConfig -PublisherName $PublisherName -Offer $Offer -Skus $SKU -Version latest;
Add-AzVMNetworkInterface -VM $vmConfig -Id $nic.Id;
$vmConfig = Set-AzVMSecurityProfile -VM $vmConfig -SecurityType $securityType;
$vmConfig = Set-AzVMUefi -VM $vmConfig -EnableVtpm $vtpm -EnableSecureBoot $secureboot;
New-AzVM -ResourceGroupName $RGName -Location $loc -VM $vmConfig;

# Verify values
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmName;
$vmExt = Get-AzVMExtension -ResourceGroupName $rgname -VMName $vmName -Name $extDefaultName;
# Check the default extension has been installed, and the Identity.Type defaulted to SystemAssigned.
# $vmExt.Name
# $vm.Identity.Type

# Use the DisableIntegrityMonitoring parameter
Remove-AzVM -ResourceGroupName $rgname -Name $vmname -Force;
New-AzVM -ResourceGroupName $rgname -Location $loc -VM $vmConfig -DisableIntegrityMonitoring;
# This VM does not have the Guest Attestation extension installed on it, and the Identity is not set to SystemAssigned by default.

この例では、GuestAttestation 拡張機能が既定でインストールされた新しい VM を作成し、DisableIntegrityMonitoring を使用して VM を再作成してこれを回避します。

パラメーター

-AddressPrefix

VM 用に作成される仮想ネットワークのアドレス プレフィックス。

Type:String
Position:Named
Default value:192.168.0.0/16
Accept pipeline input:False
Accept wildcard characters:False

-AllocationMethod

VM 用に作成されるパブリック IP の IP 割り当て方法。

Type:String
Accepted values:Static, Dynamic
Position:Named
Default value:Static
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

バックグラウンドでコマンドレットを実行し、ジョブを返して進行状況を追跡します。

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

-AvailabilitySetName

可用性セットの名前を指定します。

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

-CapacityReservationGroupId

割り当てに使用される容量予約グループの ID。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

VM の管理者資格情報。

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

-DataDiskDeleteOption

VM 削除後のデータ ディスク削除オプションを指定します。 [デタッチ]、[削除] のオプション

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

-DataDiskSizeInGb

データ ディスクのサイズを GB 単位で指定します。

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableBginfoExtension

このコマンドレットが仮想マシンに BG 情報 拡張機能をインストールしないことを示します。

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

-DisableIntegrityMonitoring

このフラグは、1) SecurityType が TrustedLaunch、2) SecurityProfile の SecureBootEnabled が true、3) SecurityProfile の VTpmEnabled が true の場合に、ゲスト構成証明拡張機能を仮想マシンにインストールする既定の動作を無効にします。

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

-DiskFile

クラウドにアップロードされ、VM を作成するための仮想ハード ディスク ファイルへのローカル パス。サフィックスとして '.vhd' が必要です。

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

-DomainNameLabel

VM の完全修飾ドメイン名 (FQDN) のサブドメイン ラベル。 これは、フォーム {domainNameLabel}.{location}.cloudapp.azure.comを取ります.

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

-EdgeZone

エッジ ゾーン名を設定します。 設定すると、クエリはメインリージョンではなく、指定されたエッジゾーンにルーティングされます。

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

-EnableUltraSSD

VM に UltraSSD ディスクを使用します。

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

-EncryptionAtHost

EncryptionAtHost プロパティは、要求のユーザーが仮想マシンまたは仮想マシン スケール セットの Host Encryption を有効または無効にするために使用できます。 これにより、ホスト自体のリソース/一時ディスクを含むすべてのディスクの暗号化が有効になります。 既定値: リソースに対してこのプロパティが true に設定されていない限り、ホストでの暗号化は無効になります。

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

-EvictionPolicy

Azure Spot 仮想マシンの削除ポリシー。 サポートされている値は、"割り当て解除" と "削除" です。

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

-GenerateSshKey

SSH 公開キーと秘密キーのペアを生成し、Azure で SSH 公開キー リソースを作成します。

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

-HibernationEnabled

VM の休止状態機能を有効または無効にするフラグ。

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

-HostGroupId

仮想マシンが存在する専用ホスト グループを指定します。

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

-HostId

ホストの ID

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

-Image

VM がビルドされるフレンドリ イメージ名。 これには、Win2022AzureEditionCore、Win2019Datacenter、Win2016Datacenter、Win2012R2Datacenter、Win2012Datacenter、Win2008R2SP1、UbuntuLTS、CentOS、CoreOS、Debian、openSUSE-Leap、RHEL、SLES が含まれます。

Type:String
Aliases:ImageName
Position:Named
Default value:Win2016Datacenter
Accept pipeline input:False
Accept wildcard characters:False

-ImageReferenceId

VM デプロイの共有ギャラリー イメージの一意の ID を指定しました。 これは、共有ギャラリー イメージ GET 呼び出しからフェッチできます。

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

-LicenseType

ライセンスの種類を指定します。これは、仮想マシンのイメージまたはディスクがオンプレミスでライセンスされたことを示します。 Windows Server で使用できる値は次のとおりです。

  • Windows_Client
  • Windows_Server Linux Server オペレーティング システムで使用できる値は次のとおりです。
  • RHEL_BYOS (RHEL の場合)
  • SLES_BYOS (SUSE の場合)
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Linux

ディスク ファイルが Linux VM 用かどうかを示します (指定されている場合)。または Windows (既定で指定されていない場合)。

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

-Location

仮想マシンの場所を指定します。

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

-MaxPrice

優先順位の低い仮想マシンの課金の最大価格。

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

-Name

VM リソースの名前。

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

-NetworkInterfaceDeleteOption

VM が削除されたときに NetworkInterface リソースに対して実行するアクションを指定します。 オプションは、デタッチ、削除です。

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

-OpenPorts

作成された VM のネットワーク セキュリティ グループ (NSG) で開くポートの一覧。 既定値は、選択したイメージの種類 (Windows: 3389、5985、Linux: 22) によって異なります。

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

-OSDiskDeleteOption

VM の削除後の OS ディスク削除オプションを指定します。 [デタッチ]、[削除] のオプション

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

-PlatformFaultDomain

仮想マシンの障害ドメインを指定します。

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

-Priority

仮想マシンの優先順位。 サポートされている値は、'Regular'、'Spot'、'Low' のみです。 "Regular" は通常の仮想マシン用です。 "スポット" はスポット仮想マシン用です。 'Low' はスポット仮想マシン用でもありますが、'Spot' に置き換えられます。 'Low' の代わりに 'Spot' を使用してください。

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

-ProximityPlacementGroupId

この仮想マシンで使用する近接通信配置グループのリソース ID。

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

-PublicIpAddressName

作成した VM で使用する新しい (または既存の) パブリック IP アドレスの名前。 指定しない場合は、名前が生成されます。

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

-ResourceGroupName

リソース グループの名前を指定します。

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

-SecurityGroupName

作成した VM で使用する新しい (または既存の) ネットワーク セキュリティ グループ (NSG) の名前。 指定しない場合は、名前が生成されます。

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

-Size

仮想マシンのサイズ。 既定値は、Standard_D2s_v3です。

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

-SshKeyName

SSH 公開キー リソースの名前。

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

-SubnetAddressPrefix

VM 用に作成されるサブネットのアドレス プレフィックス。

Type:String
Position:Named
Default value:192.168.1.0/24
Accept pipeline input:False
Accept wildcard characters:False

-SubnetName

作成した VM で使用する新しい (または既存の) サブネットの名前。 指定しない場合は、名前が生成されます。

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

-SystemAssignedIdentity

パラメーターが存在する場合、VM には自動生成されたマネージド システム ID が割り当てられます。

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

-Tag

リソースとリソース グループに一連の名前と値のペアをタグ付けできることを指定します。 リソースにタグを追加すると、異なるリソース グループのリソースをグループ化したり、独自のビューを作成したりできます。 各リソースまたはリソース グループには、最大で 15 個のタグを含めることができます。

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

-UserAssignedIdentity

VM に割り当てる必要があるマネージド サービス ID の名前。

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

-UserData

VM の UserData。これは base-64 でエンコードされます。 顧客はここにシークレットを渡すべきではありません。

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

-vCPUCountAvailable

VM で使用できる vCPU の数を指定します。 このプロパティが要求本文で指定されていない場合、既定の動作では、 リージョン内で使用可能なすべての仮想マシン サイズを一覧表示する API 応答で公開される VM サイズに対して使用可能な vCPU の値に設定します。

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

-vCPUCountPerCore

vCPU と物理コアの比率を指定します。 このプロパティが要求本文で指定されていない場合、既定の動作は、 リージョン内のすべての使用可能な仮想マシン サイズを一覧表示する API 応答で公開される VM サイズの vCPUPerCore の値に設定されます。 このプロパティを 1 に設定すると、ハイパースレッディングが無効になります。

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

-VirtualNetworkName

作成した VM で使用する新しい (または既存の) 仮想ネットワークの名前。 指定しない場合は、名前が生成されます。

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

-VM

作成するローカル仮想マシンを指定します。 仮想マシン オブジェクトを取得するには、New-AzVMConfig コマンドレットを使用します。 その他のコマンドレットを使用して、Set-AzVMOperatingSystem、Set-AzVMSourceImage、Add-AzVMNetworkInterface などの仮想マシンを構成できます。

Type:PSVirtualMachine
Aliases:VMProfile
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-VmssId

この VM が関連付けられる仮想マシン スケール セットの ID

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

仮想マシンのゾーンリストを指定します。

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

入力

String

PSVirtualMachine

String[]

Hashtable

出力

PSAzureOperationResponse

PSVirtualMachine