New-AzVM

Reference

Modul:: Az.Compute

Vytvoří virtuální počítač.

Syntaxe

New-AzVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [[-Zone] <String[]>]
   [-PublicIpSku <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>]
   [-DiskControllerType <String>]
   [-SharedGalleryImageId <String>]
   [-SecurityType <String>]
   [-EnableVtpm <Boolean>]
   [-EnableSecureBoot <Boolean>]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   [-SshKeyType <String>]
   [-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>]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-PublicIpSku <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>]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina New-AzVM vytvoří virtuální počítač v Azure. Tato rutina přebírá jako vstup objekt virtuálního počítače. Rutina New-AzVM vytvoří nový účet úložiště pro diagnostiku spouštění, pokud ještě neexistuje.

K vytvoření objektu virtuálního počítače použijte rutinu New-AzVMConfig .
Pak pomocí následujících rutin nastavte různé vlastnosti objektu virtuálního počítače:

Add-AzVMNetworkInterface pro nastavení profilu sítě.
Set-AzVMOperatingSystem pro nastavení profilu operačního systému
Set-AzVMSourceImage pro nastavení zdrojové image
Set-AzVMOSDisk pro nastavení disku s operačním systémem (profil úložiště).
Get-AzComputeResourceSku se dá použít také ke zjištění dostupných velikostí virtuálních počítačů pro vaše předplatné a oblast.

Poskytuje SimpleParameterSet pohodlnou metodu pro vytvoření virtuálního počítače tím, že běžné argumenty vytvoření virtuálního počítače jsou volitelné.

Viz Rychlý start: Kurz vytvoření virtuálního počítače s Windows v Azure pomocí PowerShellu

Příklady

Příklad 1: Vytvoření virtuálního počítače

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

Tento ukázkový skript ukazuje, jak vytvořit virtuální počítač. Skript požádá o uživatelské jméno a heslo pro virtuální počítač. Tento skript používá několik dalších rutin.

Příklad 2: Vytvoření virtuálního počítače z vlastní image uživatele

## VM Account
# Credentials for Local Admin account you created in the sysprepped (generalized) vhd image
$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -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);

$securityTypeStnd = "Standard"
$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $VMSize -SecurityType $securityTypeStnd 
$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 -Zone @("1")

Tento příklad přebírá existující image operačního systému s předponou sys a zobecněnou vlastní bitovou kopii operačního systému a připojí k ní datový disk, zřídí novou síť, nasadí virtuální pevný disk a spustí ji. Tento skript lze použít pro automatické zřizování, protože používá přihlašovací údaje místního správce virtuálního počítače vložené místo volání Get-Credential , což vyžaduje interakci uživatele. Tento skript předpokládá, že jste již přihlášení ke svému účtu Azure. Stav přihlášení můžete potvrdit pomocí rutiny Get-AzSubscription .

Příklad 3: Vytvoření virtuálního počítače z image marketplace bez veřejné IP adresy

$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$LocationName = "eastus2"
$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

Tento příkaz vytvoří virtuální počítač z image marketplace bez veřejné IP adresy.

Příklad 4: Vytvoření virtuálního počítače s hodnotou UserData:

# VM Account
$VMLocalAdminUser = "LocalAdminUser";
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -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 $Credential -DomainNameLabel $domainNameLabel -UserData $userData;
$vm = Get-AzVM -ResourceGroupName $ResourceGroupName -Name $VMName -UserData;

Hodnota UserData musí být vždy zakódovaná v Base64.

Příklad 5: Vytvoření nového virtuálního počítače s existující podsítí v jiné skupině prostředků

$UserName = "User"
$Password = ConvertTo-SecureString -String "****" -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

Tento příklad nasadí virtuální počítač s Windows z marketplace v jedné skupině prostředků s existující podsítí v jiné skupině prostředků.

Příklad 6: Vytvoření nového virtuálního počítače jako součásti VMSS s hodnotou PlatformFaultDomain

$resourceGroupName= "ResourceGroupName";
$loc = 'eastus';
New-AzResourceGroup -Name $resourceGroupName -Location $loc -Force;

$domainNameLabel = "d1" + $resourceGroupName;
$vmname = "vm" + $resourceGroupName;
$platformFaultDomainVMDefaultSet = 2;
$vmssFaultDomain = 3;
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <USERNAME>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vmssName = "vmss" + $resourceGroupName;

$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;

Tento příklad vytvoří nový virtuální počítač jako součást VMSS s hodnotou PlatformFaultDomain.

Příklad 7: Vytvoření virtuálního počítače pomocí aliasu -Image

$resourceGroupName= "<Resource Group Name>"
$loc = "<Azure Region>"
$domainNameLabel = "<Domain Name Label>"
$vmname = "<Virtual Machine Name>"
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$user = "<Username>"
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword)

New-AzResourceGroup -Name $resourceGroupName -Location $loc -Force

# Create a VM using an Image alias.
$vmname = 'v' + $resourceGroupName
$domainNameLabel = "d" + $resourceGroupName
$vm = New-AzVM -ResourceGroupName $resourceGroupName -Name $vmname -Credential $cred -Image OpenSuseLeap154Gen2 -DomainNameLabel $domainNameLabel

$vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmname

Tento příklad vytvoří nový virtuální počítač pomocí parametru -Image a poskytne virtuálnímu počítači mnoho výchozích hodnot.

Příklad 8: Vytvoření virtuálního počítače pro typ zabezpečení důvěryhodného spuštění

$rgname = <Resource Group Name>;
$loc = "eastus";
 
New-AzResourceGroup -Name $rgname -Location $loc -Force;    
# VM Profile & Hardware       
$domainNameLabel1 = 'd1' + $rgname;
$vmsize = 'Standard_D4s_v3';
$vmname1 = 'v' + $rgname;
$imageName = "Win2022AzureEdition";
$disable = $false;
$enable = $true;
$securityType = "TrustedLaunch";

$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);

# VM creation using Simple parameterset
New-AzVM -ResourceGroupName $rgname -Location $loc -Name $vmname1 -Credential $cred -Size $vmsize -Image $imageName -DomainNameLabel $domainNameLabel1 -SecurityType $securityType;
$vm1 = Get-AzVM -ResourceGroupName $rgname -Name $vmname1;

# Verify Values
#$vm1.SecurityProfile.SecurityType "TrustedLaunch";
#$vm1.SecurityProfile.UefiSettings.VTpmEnabled $true;
#$vm1.SecurityProfile.UefiSettings.SecureBootEnabled $true;

Tento příklad vytvoří nový virtuální počítač s typem zabezpečení TrustedLaunch a nastaví příznaky EnableSecureBoot a EnableVtpm jako True ve výchozím nastavení. Důvěryhodný spouštěcí virtuální počítač vyžaduje image Gen2. Další informace najdete na stránce funkce Důvěryhodné spuštění.

Příklad 9: Vytvoření virtuálního počítače se zapnutým důvěryhodným spuštěním pomocí příkazu New-AzVMConfig

$rgname = "<Resource Group Name>";
$loc = "<Azure Region>";
$vmname = 'vm' + $rgname;
$domainNameLabel = "d1" + $rgname;
$vnetname = "vn" + $rgname;
$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 = "2022-datacenter-azure-edition";
$version = "latest";
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
# Network setup
$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
$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 $version ;
Add-AzVMNetworkInterface -VM $vmConfig -Id $nic.Id;
New-AzVM -ResourceGroupName $rgname -Location $loc -VM $vmConfig;
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmname;
# Verify $vm.SecurityProfile.SecurityType is TrustedLaunch
# Verify $vm.SecurityProfile.UefiSettings.SecureBootEnabled is true.
# Verify $vm.SecurityProfile.UefiSettings.VTpmEnabled is true.

Tento příklad ukazuje, jak vytvořit virtuální počítač s platnou imagí Gen2, což virtuálnímu počítači umožní výchozí nastavení TrustedLaunch, které vyžaduje image Gen2. Další informace najdete na stránce funkce Důvěryhodné spuštění.

Příklad 10: Vytvoří virtuální počítač se zapnutým trustedLaunch ve výchozím nastavení.

$rgname = "<Resource Group Name>";
$loc = "<Azure Region>";
$vmname = 'vm' + $rgname;
$domainNameLabel = "d1" + $rgname;
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
# Create VM
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel; 
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmname;
# Verify $vm.SecurityProfile.SecurityType is TrustedLaunch.
# Verify the $vm.StorageProfile.ImageReference.Sku has defaulted to "2022-datacenter-azure-edition", a Gen2 image.

Tento příklad ukazuje, jak jednoduché volání rutiny s minimálními parametry způsobí, že důvěryhodný virtuální počítač s povolenou image Gen2. Další informace najdete na stránce funkce Důvěryhodné spuštění.

=======

Parametry

-AddressPrefix

Předpona adresy pro virtuální síť, která se vytvoří pro virtuální počítač.

Typ:	String
Position:	Named
Default value:	192.168.0.0/16
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AllocationMethod

Metoda přidělování IP adres pro veřejnou IP adresu, která se vytvoří pro virtuální počítač.

Typ:	String
Přípustné hodnoty:	Static, Dynamic
Position:	Named
Default value:	Static
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AsJob

Spusťte rutinu na pozadí a vraťte úlohu pro sledování průběhu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AvailabilitySetName

Určuje název skupiny dostupnosti.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CapacityReservationGroupId

ID skupiny rezervací kapacity, která se používá k přidělení.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Credential

Přihlašovací údaje správce pro virtuální počítač.

Uživatelské jméno
Omezení:
Windows: Nesmí obsahovat speciální znaky /"[]:|<>+=;,?*@& nebo končí na "."
Linux: Uživatelské jméno musí obsahovat jenom písmena, číslice, pomlčky a podtržítka a nesmí začínat spojovníkem nebo číslem.
Nepovolené hodnoty: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".
Minimální délka: 1 znak
Maximální délka: 20 znaků pro Windows, 64 znaků pro Linux

Heslo
Musí mít 3 z následujících znaků: 1 malé písmeno, 1 velké písmeno, 1 číslo a 1 speciální znak.
Hodnota musí mít délku 12 až 123 znaků.

Typ:	PSCredential
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataDiskDeleteOption

Určuje možnost odstranění datového disku po odstranění virtuálního počítače. Možnosti jsou Odpojení, Odstranění

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataDiskSizeInGb

Určuje velikosti datových disků v GB.

Typ:	Int32[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableBginfoExtension

Označuje, že tato rutina nenainstaluje rozšíření BG Info na virtuální počítač.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DiskControllerType

Určuje typ řadiče disku nakonfigurovaného pro virtuální počítač a VirtualMachineScaleSet. Tato vlastnost je podporována pouze pro virtuální počítače, jejichž disk s operačním systémem a skladová položka virtuálního počítače podporují generaci 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), zkontrolujte, jestli funkce HyperVGenerations vrácená jako součást možností skladové položky virtuálního počítače v reakci na rozhraní API skladových položek Microsoft.Compute pro tuto oblast obsahuje V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list).
Další informace o podporovaných typech řadiče disku naleznete v tématu https://aka.ms/azure-diskcontrollertypes.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DiskFile

Místní cesta k souboru virtuálního pevného disku, který se má nahrát do cloudu, a pro vytvoření virtuálního počítače a musí mít příponu .vhd.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DomainNameLabel

Popisek subdomény pro plně kvalifikovaný název domény (FQDN) virtuálního počítače. To bude mít formulář {domainNameLabel}.{location}.cloudapp.azure.com.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EdgeZone

Nastaví název hraniční zóny. Pokud je tato možnost nastavená, dotaz bude směrován do zadaného hraničního pásma místo do hlavní oblasti.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-EnableSecureBoot

Určuje, jestli má být na virtuálním počítači povolené zabezpečené spouštění.

Typ:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-EnableUltraSSD

Pro virtuální počítač použijte disky UltraSSD.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EnableVtpm

Určuje, jestli má být na virtuálním počítači povolený virtuální počítač vTPM.

Typ:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-EncryptionAtHost

Vlastnost EncryptionAtHost může uživatel v požadavku použít k povolení nebo zakázání šifrování hostitele pro virtuální počítač nebo škálovací sadu virtuálních počítačů. Tím povolíte šifrování pro všechny disky, včetně samotného prostředku nebo dočasného disku v hostiteli. Výchozí: Šifrování v hostiteli bude zakázáno, pokud není tato vlastnost nastavena na hodnotu true pro prostředek.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EvictionPolicy

Zásady vyřazení pro spotový virtuální počítač Azure Podporované hodnoty jsou Deallocate (Uvolnit) a Delete (Odstranit).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-GenerateSshKey

Vygenerujte pár veřejného/privátního klíče SSH a vytvořte prostředek veřejného klíče SSH v Azure.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-HibernationEnabled

Příznak, který povolí nebo zakáže funkci hibernace na virtuálním počítači.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-HostGroupId

Určuje vyhrazenou skupinu hostitelů, ve které se bude virtuální počítač nacházet.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-HostId

ID hostitele

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IfMatch

slouží k podmíněnému požadavku pro PUT a další nebezpečné metody. Server vrátí požadované prostředky pouze v případě, že prostředek odpovídá jedné z uvedených hodnot značky ETag. Tuto hodnotu vynecháte, pokud chcete aktuální prostředek vždy přepsat. Zadejte naposledy zobrazenou hodnotu značky ETag, abyste zabránili náhodnému přepsání souběžných změn.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-IfNoneMatch

Používá se k podmíněnému požadavku pro metody GET a HEAD. Server vrátí požadované prostředky pouze v případě, že žádná z uvedených hodnot značky ETag neodpovídá aktuální entitě. Používá se k podmíněnému požadavku pro metody GET a HEAD. Server vrátí požadované prostředky pouze v případě, že žádná z uvedených hodnot značky ETag neodpovídá aktuální entitě. Pokud chcete povolit vytvoření nové sady záznamů, nastavte na *, ale chcete-li zabránit aktualizaci existující sady záznamů. Jiné hodnoty budou mít za následek chybu ze serveru, protože nejsou podporované.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Image

Popisný název image, na které bude virtuální počítač sestaven. Dostupné aliasy jsou: Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, Ubuntu2204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.

Typ:	String
Aliasy:	ImageName
Position:	Named
Default value:	Win2016Datacenter
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ImageReferenceId

Zadali jste jedinečné ID image sdílené galerie pro nasazení virtuálního počítače. To se dá načíst z volání GET sdíleného obrázku galerie.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LicenseType

Určuje typ licence, který označuje, že image nebo disk virtuálního počítače byly licencované místně. Možné hodnoty pro Windows Server jsou:

Windows_Client
Windows_Server

Možné hodnoty operačního systému Linux Server jsou:

RHEL_BYOS (pro RHEL)
SLES_BYOS (pro SUSE)

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Linux

Určuje, jestli je soubor disku pro virtuální počítač s Linuxem, pokud je zadaný; nebo Windows, pokud není ve výchozím nastavení zadáno.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Location

Určuje umístění virtuálního počítače.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MaxPrice

Maximální cena fakturace virtuálního počítače s nízkou prioritou.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název prostředku virtuálního počítače.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NetworkInterfaceDeleteOption

Určuje, jaká akce se má provést u prostředku NetworkInterface při odstranění virtuálního počítače. Možnosti jsou: Odpojení, odstranění.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OpenPorts

Seznam portů, které se mají otevřít ve skupině zabezpečení sítě (NSG) pro vytvořený virtuální počítač. Výchozí hodnota závisí na typu zvolené image (tj. Windows: 3389, 5985 a Linux: 22).

Typ:	Int32[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OSDiskDeleteOption

Určuje možnost odstranění disku s operačním systémem po odstranění virtuálního počítače. Možnosti jsou Odpojení, Odstranění

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PlatformFaultDomain

Určuje doménu selhání virtuálního počítače.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Priority

Priorita virtuálního počítače. Podporované hodnoty jsou "Regular", "Spot" a "Low". Pravidelná hodnota je určená pro běžný virtuální počítač. Spot je určený pro spotový virtuální počítač. "Nízká" je také pro spotový virtuální počítač, ale nahrazuje se slovem "Spot". Místo "Low" použijte "Spot".

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ProximityPlacementGroupId

ID prostředku skupiny umístění bezkontaktní komunikace, které se má použít s tímto virtuálním počítačem.

Typ:	String
Aliasy:	ProximityPlacementGroup
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PublicIpAddressName

Název nové (nebo existující) veřejné IP adresy vytvořeného virtuálního počítače, který se má použít. Pokud není zadaný, vygeneruje se název.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PublicIpSku

Určuje název skladové položky veřejné IP adresy.

Přijaté hodnoty jsou "Basic" a "Standard"

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Určuje název skupiny prostředků.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SecurityGroupName

Název nové (nebo existující) skupiny zabezpečení sítě (NSG) pro vytvořený virtuální počítač, který se má použít. Pokud není zadaný, vygeneruje se název.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SecurityType

Určuje typ zabezpečení virtuálního počítače. Aby bylo možné povolit UefiSettings, musí být nastavená na libovolnou zadanou hodnotu. Ve výchozím nastavení se UefiSettings nepovolí, pokud není tato vlastnost nastavená.

Typ:	String
Přípustné hodnoty:	TrustedLaunch, ConfidentialVM, Standard
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SharedGalleryImageId

Zadali jste jedinečné ID image sdílené galerie pro nasazení virtuálního počítače. To se dá načíst z volání GET sdíleného obrázku galerie.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Size

Velikost virtuálního počítače. Get-AzComputeResourceSku se dá použít ke zjištění dostupných velikostí pro vaše předplatné a oblast.
Výchozí hodnota je: Standard_D2s_v3.

Typ:	String
Position:	Named
Default value:	Standard_D2s_v3
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SshKeyName

Název prostředku veřejného klíče SSH

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SshKeyType

Zadejte typ klíče SSH, který se má vygenerovat. Povolené hodnoty jsou Ed25519 a RSA.

Typ:	String
Přípustné hodnoty:	Ed25519, RSA
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubnetAddressPrefix

Předpona adresy pro podsíť, která se vytvoří pro virtuální počítač.

Typ:	String
Position:	Named
Default value:	192.168.1.0/24
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubnetName

Název nové (nebo existující) podsítě, kterou má vytvořený virtuální počítač použít. Pokud není zadaný, vygeneruje se název.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SystemAssignedIdentity

Pokud je parametr k dispozici, přiřadí se virtuálnímu počítači identita spravovaného systému, která se automaticky vygeneruje.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Tag

Určuje, že prostředky a skupiny prostředků lze označit sadou párů název-hodnota. Přidání značek k prostředkům umožňuje seskupit prostředky mezi skupinami prostředků a vytvořit vlastní zobrazení. Každý prostředek nebo skupina prostředků může mít maximálně 15 značek.

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-UserAssignedIdentity

Název identity spravované služby, která by měla být přiřazena k virtuálnímu počítači.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UserData

UserData pro virtuální počítač, který bude kódován v base-64. Zákazník by zde neměl předávat žádné tajné kódy.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-vCPUCountAvailable

Určuje počet virtuálních procesorů dostupných pro virtuální počítač. Pokud tato vlastnost není v textu požadavku zadána, výchozí chování je nastavit ji na hodnotu virtuálních procesorů dostupných pro danou velikost virtuálního počítače vystavenou v odpovědi rozhraní API seznamu všech dostupných velikostí virtuálních počítačů v dané oblasti.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-vCPUCountPerCore

Určuje poměr virtuálních procesorů k fyzickému jádru. Pokud tato vlastnost není zadána v textu požadavku výchozí chování je nastavena na hodnotu vCPUsPerCore pro velikost virtuálního počítače vystavené v odpovědi rozhraní API v odpovědi Na seznam všech dostupných velikostí virtuálních počítačů v oblasti. Nastavení této vlastnosti na hodnotu 1 také znamená, že hyper-threading je zakázán.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-VirtualNetworkName

Název nové (nebo existující) virtuální sítě, kterou má vytvořený virtuální počítač použít. Pokud není zadaný, vygeneruje se název.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VM

Určuje místní virtuální počítač, který se má vytvořit. K získání objektu virtuálního počítače použijte rutinu New-AzVMConfig. Další rutiny je možné použít ke konfiguraci virtuálního počítače, jako je Set-AzVMOperatingSystem, Set-AzVMSourceImage a Add-AzVMNetworkInterface.

Typ:	PSVirtualMachine
Aliasy:	VMProfile
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-VmssId

ID škálovací sady virtuálních počítačů, ke které bude tento virtuální počítač přidružený

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Zone

Určuje zónu virtuálního počítače. Přestože zabírá pole zón, virtuální počítače nepodporují více zón dostupnosti. Povolená hodnota závisí na možnostech oblasti. Povolená hodnota bude obvykle 1, 2 nebo 3. Další informace o zónách dostupnosti Azure

Typ:	String[]
Position:	3
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSVirtualMachine

String[]

Hashtable

Výstupy

PSAzureOperationResponse