Dela via


New-AzVM

Skapar en virtuell dator.

Syntax

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

New-AzVM-cmdleten skapar en virtuell dator i Azure. Den här cmdleten tar ett virtuellt datorobjekt som indata. New-AzVM-cmdleten skapar ett nytt lagringskonto för startdiagnostik om det inte redan finns något.

Använd cmdleten New-AzVMConfig för att skapa ett virtuellt datorobjekt.
Använd sedan följande cmdletar för att ange olika egenskaper för objektet för den virtuella datorn:

Exempel

Exempel 1: Skapa en virtuell dator

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

Det här exempelskriptet visar hur du skapar en virtuell dator. Skriptet frågar efter användarnamn och lösenord för den virtuella datorn. Det här skriptet använder flera andra cmdletar.

Exempel 2: Skapa en virtuell dator från en anpassad användarbild

## 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")

Det här exemplet tar en befintlig sys-förberedd, generaliserad anpassad operativsystemavbildning och kopplar en datadisk till den, etablerar ett nytt nätverk, distribuerar den virtuella hårddisken och kör den. Det här skriptet kan användas för automatisk etablering eftersom det använder administratörsuppgifterna för den lokala virtuella datorn infogade i stället för att anropa Get-Credential som kräver användarinteraktion. Det här skriptet förutsätter att du redan är inloggad på ditt Azure-konto. Du kan bekräfta din inloggningsstatus med hjälp av cmdleten Get-AzSubscription .

Exempel 3: Skapa en virtuell dator från en marketplace-avbildning utan en offentlig IP-adress

$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

Det här kommandot skapar en virtuell dator från en Marketplace-avbildning utan en offentlig IP-adress.

Exempel 4: Skapa en virtuell dator med ett UserData-värde:

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

UserData-värdet måste alltid vara Base64-kodat.

Exempel 5: Skapa en ny virtuell dator med ett befintligt undernät i en annan resursgrupp

$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

Det här exemplet distribuerar en virtuell Windows-dator från marknadsplatsen i en resursgrupp med ett befintligt undernät i en annan resursgrupp.

Exempel 6: Skapa en ny virtuell dator som en del av en VMSS med ett PlatformFaultDomain-värde.

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

Det här exemplet skapar en ny virtuell dator som en del av en VMSS med ett PlatformFaultDomain-värde.

Exempel 7: Skapa en virtuell dator med aliaset -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

I det här exemplet skapas en ny virtuell dator med parametern -Image, vilket ger den virtuella datorn många standardvärden.

Exempel 8: Skapa en virtuell dator för Trusted Launch SecurityType.

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

I det här exemplet skapas en ny virtuell dator med säkerhetstypen TrustedLaunch och flaggorna EnableSecureBoot och EnableVtpm anges som True som standard. En betrodd virtuell dator för start kräver en Gen2-avbildning. Mer information finns på funktionssidan Betrodd start.

Exempel 9: Skapa en virtuell dator med betrodd start aktiverad med defualt med 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.

Det här exemplet visar hur du skapar en virtuell dator med en giltig Gen2-avbildning, vilket gör att den virtuella datorn som standard är TrustedLaunch, vilket kräver Gen2-avbildningar. Mer information finns på funktionssidan Betrodd start.

Exempel 10: Skapar en virtuell dator med TrustedLaunch aktiverat som standard.

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

Det här exemplet visar hur det enkla cmdlet-anropet med minimala parametrar resulterar i en TrustedLaunch-aktiverad virtuell dator med en Gen2-avbildning. Mer information finns på funktionssidan Betrodd start.

=======

Parametrar

-AddressPrefix

Adressprefixet för det virtuella nätverket som skapas för den virtuella datorn.

Typ:String
Position:Named
Standardvärde:192.168.0.0/16
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AllocationMethod

IP-allokeringsmetoden för den offentliga IP-adressen som skapas för den virtuella datorn.

Typ:String
Godkända värden:Static, Dynamic
Position:Named
Standardvärde:Static
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AsJob

Kör cmdleten i bakgrunden och returnera ett jobb för att spåra förloppet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AvailabilitySetName

Anger ett namn för tillgänglighetsuppsättningen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CapacityReservationGroupId

ID för kapacitetsreservationsgruppen som används för allokering.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Administratörsautentiseringsuppgifterna för den virtuella datorn.

Användarnamn
Begränsning:
Windows: Får inte innehålla specialtecken /""[]:|<>+=;,?*@& eller sluta med ".".
Linux: Användarnamn får endast innehålla bokstäver, siffror, bindestreck och understreck och får inte börja med ett bindestreck eller tal.
Otillåtna värden: "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".
Minsta längd: 1 tecken
Maxlängd: 20 tecken för Windows, 64 tecken för Linux

Lösenord
Måste ha 3 av följande: 1 gemener, 1 versaler, 1 tal och 1 specialtecken.
Värdet måste vara mellan 12 och 123 tecken långt.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataDiskDeleteOption

Anger alternativet borttagning av datadisk efter att den virtuella datorn har tagits bort. Alternativen är Koppla från, Ta bort

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataDiskSizeInGb

Anger storleken på datadiskar i GB.

Typ:Int32[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisableBginfoExtension

Anger att den här cmdleten inte installerar BG Info-tillägget på den virtuella datorn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskControllerType

Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn och VirtualMachineScaleSet. Den här egenskapen stöds endast för virtuella datorer vars operativsystemdisk och VM-sku stöder generation 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), kontrollera att HyperVGenerations-funktionen som returneras som en del av vm-sku-funktionerna i svaret från Microsoft.Compute SKU:er api för regionen innehåller V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list) .
Mer information om de typer av diskkontrollanter som stöds finns i https://aka.ms/azure-diskcontrollertypes.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskFile

Den lokala sökvägen till den virtuella hårddiskfilen som ska laddas upp till molnet och för att skapa den virtuella datorn, och den måste ha ".vhd" som suffix.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DomainNameLabel

Underdomänetiketten för den virtuella datorns fullständigt kvalificerade domännamn (FQDN). Detta kommer att ta formuläret {domainNameLabel}.{location}.cloudapp.azure.com.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EdgeZone

Anger gränszonens namn. Om den anges dirigeras frågan till den angivna gränszonen i stället för huvudregionen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EnableSecureBoot

Anger om säker start ska aktiveras på den virtuella datorn.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EnableUltraSSD

Använd UltraSSD-diskar för den virtuella datorn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableVtpm

Anger om vTPM ska aktiveras på den virtuella datorn.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EncryptionAtHost

Egenskapen EncryptionAtHost kan användas av användaren i begäran för att aktivera eller inaktivera värdkryptering för den virtuella datorn eller vm-skalningsuppsättningen. Detta aktiverar krypteringen för alla diskar, inklusive resurs/temp-disk på själva värden. Standard: Krypteringen på värden inaktiveras om inte den här egenskapen är inställd på true för resursen.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EvictionPolicy

Borttagningsprincipen för den virtuella Azure Spot-datorn. Värden som stöds är "Frigör" och "Ta bort".

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GenerateSshKey

Generera ett offentligt/privat SSH-nyckelpar och skapa en offentlig SSH-nyckelresurs i Azure.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HibernationEnabled

Flaggan som aktiverar eller inaktiverar vilolägesfunktionen på den virtuella datorn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HostGroupId

Anger den dedikerade värdgrupp som den virtuella datorn ska finnas i.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HostId

Värdens ID

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IfMatch

används för att göra en begäran villkorsstyrd för PUT och andra icke-säkra metoder. Servern returnerar endast de begärda resurserna om resursen matchar något av de angivna ETag-värdena. Utelämna det här värdet för att alltid skriva över den aktuella resursen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-IfNoneMatch

Används för att göra en begäran villkorsstyrd för GET- och HEAD-metoderna. Servern returnerar endast de begärda resurserna om inget av de angivna ETag-värdena matchar den aktuella entiteten. Används för att göra en begäran villkorsstyrd för GET- och HEAD-metoderna. Servern returnerar endast de begärda resurserna om inget av de angivna ETag-värdena matchar den aktuella entiteten. Ange till *för att tillåta att en ny postuppsättning skapas, men för att förhindra uppdatering av en befintlig postuppsättning. Andra värden resulterar i fel från servern eftersom de inte stöds.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Image

Det egna avbildningsnamnet som den virtuella datorn ska byggas på. Tillgängliga alias är: Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, Ubuntu2204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.

Typ:String
Alias:ImageName
Position:Named
Standardvärde:Win2016Datacenter
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferenceId

Angav det unika ID:t för den delade galleriavbildningen för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LicenseType

Anger en licenstyp som anger att avbildningen eller disken för den virtuella datorn har licensierats lokalt. Möjliga värden för Windows Server är:

  • Windows_Client
  • Windows_Server

Möjliga värden för Linux Server-operativsystemet är:

  • RHEL_BYOS (för RHEL)
  • SLES_BYOS (för SUSE)
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Linux

Anger om diskfilen är för en virtuell Linux-dator, om den anges. eller Windows, om det inte anges som standard.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Anger en plats för den virtuella datorn.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxPrice

Maxpriset för faktureringen för en virtuell dator med låg prioritet.

Typ:Double
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på den virtuella datorresursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NetworkInterfaceDeleteOption

Anger vilken åtgärd som ska utföras på NetworkInterface-resursen när den virtuella datorn tas bort. Alternativen är: Koppla från, Ta bort.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OpenPorts

En lista över portar som ska öppnas i nätverkssäkerhetsgruppen (NSG) för den skapade virtuella datorn. Standardvärdet beror på vilken typ av avbildning som valts (d.v.s. Windows: 3389, 5985 och Linux: 22).

Typ:Int32[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OSDiskDeleteOption

Anger borttagningsalternativet os-disk efter att den virtuella datorn har tagits bort. Alternativen är Koppla från, Ta bort

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PlatformFaultDomain

Anger feldomänen för den virtuella datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Priority

Prioriteten för den virtuella datorn. Endast värden som stöds är "Regular", "Spot" och "Low". "Regular" är för vanlig virtuell dator. "Spot" är för virtuell dator med oanvänd kapacitet. "Låg" är också för virtuell dator med oanvänd kapacitet men ersätts med "Spot". Använd "Spot" i stället för "Low".

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProximityPlacementGroupId

Resurs-ID för närhetsplaceringsgruppen som ska användas med den här virtuella datorn.

Typ:String
Alias:ProximityPlacementGroup
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIpAddressName

Namnet på en ny (eller befintlig) offentlig IP-adress som den skapade virtuella datorn ska använda. Om det inte anges genereras ett namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIpSku

Anger namn på offentlig IP-sku

Godkända värden är "Basic" och "Standard"

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på en resursgrupp.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SecurityGroupName

Namnet på en ny (eller befintlig) nätverkssäkerhetsgrupp (NSG) som den skapade virtuella datorn ska använda. Om det inte anges genereras ett namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SecurityType

Anger SecurityType för den virtuella datorn. Det måste anges till ett angivet värde för att aktivera UefiSettings. Som standard aktiveras inte UefiSettings om inte den här egenskapen har angetts.

Typ:String
Godkända värden:TrustedLaunch, ConfidentialVM, Standard
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SharedGalleryImageId

Angav det unika ID:t för den delade galleriavbildningen för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Size

Storleken på den virtuella datorn. Get-AzComputeResourceSku kan användas för att ta reda på tillgängliga storlekar för din prenumeration och region.
Standardvärdet är: Standard_D2s_v3.

Typ:String
Position:Named
Standardvärde:Standard_D2s_v3
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshKeyName

Namnet på SSH Public Key-resursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshKeyType

Ange vilken typ av SSH-nyckel som ska genereras. Tillåtna värden är "Ed25519" och "RSA".

Typ:String
Godkända värden:Ed25519, RSA
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetAddressPrefix

Adressprefixet för undernätet som ska skapas för den virtuella datorn.

Typ:String
Position:Named
Standardvärde:192.168.1.0/24
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetName

Namnet på ett nytt (eller befintligt) undernät som den skapade virtuella datorn ska använda. Om det inte anges genereras ett namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SystemAssignedIdentity

Om parametern finns tilldelas den virtuella datorn en hanterad systemidentitet som genereras automatiskt.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Anger att resurser och resursgrupper kan taggas med en uppsättning namn/värde-par. Genom att lägga till taggar i resurser kan du gruppera resurser mellan resursgrupper och skapa egna vyer. Varje resurs eller resursgrupp kan som mest ha 15 taggar.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UserAssignedIdentity

Namnet på en hanterad tjänstidentitet som ska tilldelas till den virtuella datorn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserData

UserData för den virtuella datorn, som kommer att vara base-64-kodad. Kunden bör inte skicka in några hemligheter här.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-vCPUCountAvailable

Anger antalet virtuella processorer som är tillgängliga för den virtuella datorn. När den här egenskapen inte anges i begärandetexten är standardbeteendet att ange värdet för vCPU:er som är tillgängliga för den virtuella datorstorleken som exponeras i API-svaret i Lista alla tillgängliga storlekar på virtuella datorer i en region.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-vCPUCountPerCore

Anger förhållandet mellan vCPU och fysisk kärna. När den här egenskapen inte anges i begärandetexten anges standardbeteendet till värdet för vCPUsPerCore för vm-storleken som exponeras i API-svaret i Lista alla tillgängliga storlekar på virtuella datorer i en region. Om du anger den här egenskapen till 1 innebär det också att hypertrådning är inaktiverat.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualNetworkName

Namnet på ett nytt (eller befintligt) virtuellt nätverk som den skapade virtuella datorn ska använda. Om det inte anges genereras ett namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VM

Anger en lokal virtuell dator som ska skapas. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten New-AzVMConfig. Andra cmdletar kan användas för att konfigurera den virtuella datorn, till exempel Set-AzVMOperatingSystem, Set-AzVMSourceImage och Add-AzVMNetworkInterface.

Typ:PSVirtualMachine
Alias:VMProfile
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VmssId

ID:t för vm-skalningsuppsättningen som den här virtuella datorn ska associeras med

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

Anger zonen för den virtuella datorn. Även om det tar in en matris med zoner stöder virtuella datorer inte flera tillgänglighetszoner. Det tillåtna värdet beror på regionens funktioner. Det tillåtna värdet är normalt 1, 2 eller 3. Mer information om Azure-tillgänglighetszoner.

Typ:String[]
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

PSVirtualMachine

String[]

Hashtable

Utdata

PSAzureOperationResponse

PSVirtualMachine