New-AzVM

Referenz

Modul:: Az.Compute

Erstellt einen virtuellen Computer.

Syntax

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>]

Beschreibung

Das Cmdlet New-AzVM erstellt einen virtuellen Computer in Azure. Dieses Cmdlet verwendet ein virtuelles Computerobjekt als Eingabe. Verwenden Sie das Cmdlet New-AzVMConfig, um ein virtuelles Computerobjekt zu erstellen. Das Cmdlet New-AzVM erstellt ein neues Speicherkonto für die Startdiagnose, wenn noch nicht vorhanden ist. Andere Cmdlets können verwendet werden, um den virtuellen Computer zu konfigurieren, z. B. Set-AzVMOperatingSystem, Set-AzVMSourceImage, Add-AzVMNetworkInterface und Set-AzVMOSDisk. Dies SimpleParameterSet bietet eine bequeme Methode zum Erstellen eines virtuellen Computers, indem allgemeine VM-Erstellungsargumente optional erstellt werden.

Beispiele

Beispiel 1: Erstellen eines virtuellen Computers

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

In diesem Beispielskript wird gezeigt, wie Sie einen virtuellen Computer erstellen. Das Skript fragt einen Benutzernamen und ein Kennwort für den virtuellen Computer. Dieses Skript verwendet mehrere andere Cmdlets.

Beispiel 2: Erstellen eines virtuellen Computers aus einem benutzerdefinierten Benutzerimage

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

In diesem Beispiel wird ein vorhandenes sys-prepped-, generalisiertes Betriebssystemimage verwendet und ein Datenträger an ihn angefügt, ein neues Netzwerk bereitgestellt, die VHD bereitgestellt und ausgeführt. Dieses Skript kann für die automatische Bereitstellung verwendet werden, da er die anmeldeinformationen für den lokalen virtuellen Computer anstelle des Aufrufens von Get-Credential verwendet, die die Benutzerinteraktion erfordern. Dieses Skript geht davon aus, dass Sie bereits in Ihrem Azure-Konto angemeldet sind. Sie können Ihren Anmeldestatus bestätigen, indem Sie das Cmdlet Get-AzSubscription verwenden.

Beispiel 3: Erstellen einer VM aus einem Marketplace-Image ohne öffentliche IP

$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

Dieser Befehl erstellt eine VM aus einem Marketplace-Image ohne öffentliche IP.

Beispiel 4: Erstellen einer VM mit einem UserData-Wert:

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

Der UserData-Wert muss immer base64 codiert sein.

Beispiel 5: Erstellen einer neuen VM mit einem vorhandenen Subnetz in einer anderen Ressourcengruppe

$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

In diesem Beispiel wird eine Windows-VM aus dem Marketplace in einer Ressourcengruppe mit einem vorhandenen Subnetz in einer anderen Ressourcengruppe bereitgestellt.

Beispiel 6: Erstellen einer neuen VM als Teil eines VMSS mit einem PlatformFaultDomain-Wert.

$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

In diesem Beispiel wird eine neue VM als Teil eines VMSS mit einem PlatformFaultDomain-Wert erstellt.

Beispiel 7: Erstellen einer neuen VM mit der standardmäßig installierten GuestAttestation-Erweiterung, und erstellen Sie dann die VM mit DisableIntegrityMonitoring erneut, um dies zu verhindern.

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

In diesem Beispiel wird eine neue VM mit der standardmäßig installierten GuestAttestation-Erweiterung erstellt und dann die VM mit DisableIntegrityMonitoring erneut erstellt, um dies zu verhindern.

Parameter

-AddressPrefix

Das Adresspräfix für das virtuelle Netzwerk, das für den virtuellen Computer erstellt wird.

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

-AllocationMethod

Die IP-Zuordnungsmethode für die öffentliche IP, die für den virtuellen Computer erstellt wird.

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

-AsJob

Führen Sie das Cmdlet im Hintergrund aus, und geben Sie einen Auftrag zurück, um den Fortschritt zu verfolgen.

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

-AvailabilitySetName

Gibt einen Namen für den Verfügbarkeitssatz an.

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

-CapacityReservationGroupId

Id der Kapazitätsreservierungsgruppe, die zum Zuweisen verwendet wird.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Die Administratoranmeldeinformationen für den virtuellen Computer.

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

-DataDiskDeleteOption

Gibt die Option zum Löschen von Datendatenträgern nach dem Vm-Löschen an. Optionen sind Trennzeichen, Löschen

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

-DataDiskSizeInGb

Gibt die Größe von Datenträgern in GB an.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-DisableBginfoExtension

Gibt an, dass dieses Cmdlet die BG Info-Erweiterung auf dem virtuellen Computer nicht installiert.

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

-DisableIntegrityMonitoring

Dieses Flag deaktiviert das Standardverhalten, um die Erweiterung der Gastbestätigung auf dem virtuellen Computer zu installieren, wenn: 1) SecurityType ist TrustedLaunch, 2) SecureBootEnabled auf dem SecurityProfile ist true, 3) VTpmEnabled auf dem SecurityProfile ist true.

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

-DiskFile

Der lokale Pfad zur virtuellen Festplatte, die in die Cloud hochgeladen werden soll, und zum Erstellen der VM, und es muss ".vhd" als Suffix aufweisen.

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

-DomainNameLabel

Die Unterdomänenbezeichnung für den vollqualifizierten Domänennamen (FQDN) des virtuellen Computers. Dadurch wird das Formular {domainNameLabel}.{location}.cloudapp.azure.comverwendet.

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

-EdgeZone

Legt den Namen der Edgezone fest. Wenn festgelegt, wird die Abfrage anstelle des Hauptbereichs an die angegebene Edgezone weitergeleitet.

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

-EnableUltraSSD

Verwenden Sie UltraSSD-Datenträger für den virtuellen Computer.

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

-EncryptionAtHost

EncryptionAtHost-Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder den Skalierungssatz des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger, einschließlich Ressourcen-/Temp-Datenträger, beim Host selbst aktiviert. Standard: Die Verschlüsselung auf dem Host wird deaktiviert, es sei denn, diese Eigenschaft ist auf "true" für die Ressource festgelegt.

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

-EvictionPolicy

Die Eviction-Richtlinie für den virtuellen Azure Spot-Computer. Unterstützte Werte sind "Deallocate" und "Delete".

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

-GenerateSshKey

Generieren Sie ein SSH Public/Private Key-Paar und erstellen Sie eine SSH Public Key-Ressource in Azure.

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

-HibernationEnabled

Das Flag, das die Funktion "Hibernation" auf dem virtuellen Computer aktiviert oder deaktiviert.

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

-HostGroupId

Gibt die dedizierte Hostgruppe an, in der sich der virtuelle Computer befindet.

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

-HostId

Die ID des Hosts

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

-Image

Der Anzeigeimagename, auf dem die VM erstellt wird. Dazu gehören: 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

Gibt die eindeutige ID des freigegebenen Katalogimages für die vm-Bereitstellung an. Dies kann von einem freigegebenen Katalogbild GET-Aufruf abgerufen werden.

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

-LicenseType

Gibt einen Lizenztyp an, der angibt, dass das Image oder der Datenträger für den virtuellen Computer lokal lizenziert wurde. Mögliche Werte für Windows Server sind:

Windows_Client
Windows_Server Mögliche Werte für das Linux Server-Betriebssystem sind:
RHEL_BYOS (für RHEL)
SLES_BYOS (für SUSE)

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

-Linux

Gibt an, ob die Datenträgerdatei für Linux VM ist, falls angegeben; oder Windows, wenn nicht standardmäßig angegeben.

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

-Location

Gibt einen Speicherort für den virtuellen Computer an.

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

-MaxPrice

Der maximale Preis der Abrechnung eines virtuellen Computers mit niedriger Priorität.

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

-Name

Der Name der VM-Ressource.

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

-NetworkInterfaceDeleteOption

Gibt an, welche Aktion auf der NetworkInterface-Ressource ausgeführt werden soll, wenn die VM gelöscht wird. Optionen sind: Trennen, Löschen.

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

-OpenPorts

Eine Liste der Ports, die in der Netzwerksicherheitsgruppe (NSG) für die erstellte VM geöffnet werden sollen. Der Standardwert hängt vom ausgewählten Bildtyp ab (d. h. Windows: 3389, 5985 und Linux: 22).

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

-OSDiskDeleteOption

Gibt die Option zum Löschen des Betriebssystemdatenträgers nach dem VM-Löschen an. Optionen sind Trennzeichen, Löschen

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

-PlatformFaultDomain

Gibt die Fehlerdomäne des virtuellen Computers an.

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

-Priority

Die Priorität für den virtuellen Computer. Nur unterstützte Werte sind "Regular", "Spot" und "Low". "Normal" ist für reguläre virtuelle Computer. "Spot" ist für einen virtuellen Computer vor Ort. "Niedrig" ist auch für einen virtuellen Spotcomputer, wird jedoch durch "Spot" ersetzt. Verwenden Sie "Spot" anstelle von "Niedrig".

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

-ProximityPlacementGroupId

Die Ressourcen-ID der Näherungsplatzierungsgruppe, die mit diesem virtuellen Computer verwendet werden soll.

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

-PublicIpAddressName

Der Name einer neuen (oder vorhandenen) öffentlichen IP-Adresse für die erstellte VM, die verwendet werden soll. Wenn nicht angegeben, wird ein Name generiert.

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

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an.

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

-SecurityGroupName

Der Name einer neuen (oder vorhandenen) Netzwerksicherheitsgruppe (NSG) für die erstellte VM, die verwendet werden soll. Wenn nicht angegeben, wird ein Name generiert.

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

-Size

Die Größe des virtuellen Computers. Der Standardwert lautet: Standard_D2s_v3.

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

-SshKeyName

Name der SSH Public Key-Ressource.

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

-SubnetAddressPrefix

Das Adresspräfix für das Subnetz, das für die VM erstellt wird.

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

-SubnetName

Der Name eines neuen (oder vorhandenen) Subnetzs für die erstellte VM, die verwendet werden soll. Wenn nicht angegeben, wird ein Name generiert.

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

-SystemAssignedIdentity

Wenn der Parameter vorhanden ist, wird der VM eine verwaltete Systemidentität zugewiesen, die automatisch generiert wird.

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

-Tag

Gibt an, dass Ressourcen und Ressourcengruppen mit einem Satz von Namenswertpaaren gekennzeichnet werden können. Das Hinzufügen von Tags zu Ressourcen ermöglicht das Gruppieren von Ressourcen über Ressourcengruppen hinweg sowie das Erstellen eigener Ansichten. Jede Ressource oder Ressourcengruppe kann maximal 15 Tags haben.

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

-UserAssignedIdentity

Der Name einer verwalteten Dienstidentität, die dem virtuellen Computer zugewiesen werden soll.

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

-UserData

UserData für die VM, die basis-64 codiert ist. Der Kunde sollte hier keine Geheimnisse übergeben.

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

-vCPUCountAvailable

Gibt die Anzahl der für den virtuellen Computer verfügbaren vCPUs an. Wenn diese Eigenschaft im Anforderungstext nicht angegeben wird, soll das Standardverhalten auf den Wert von vCPUs festgelegt werden, der für diese VM-Größe in der API-Antwort der Liste aller verfügbaren virtuellen Computergrößen in einem Bereich verfügbar ist.

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

-vCPUCountPerCore

Gibt das vCPU-Verhältnis zu physischem Kernverhältnis an. Wenn diese Eigenschaft im Anforderungstext nicht angegeben wird, wird das Standardverhalten auf den Wert von vCPUsPerCore für die VM-Größe festgelegt, die in der API-Antwort der Liste aller verfügbaren virtuellen Computergrößen in einem Bereich verfügbar ist. Das Festlegen dieser Eigenschaft auf 1 bedeutet auch, dass hyperthreading deaktiviert ist.

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

-VirtualNetworkName

Der Name eines neuen (oder vorhandenen) virtuellen Netzwerks für die erstellte VM, die verwendet werden soll. Wenn nicht angegeben, wird ein Name generiert.

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

-VM

Gibt einen lokalen virtuellen Computer an, der erstellt werden soll. Verwenden Sie zum Abrufen eines virtuellen Computerobjekts das Cmdlet New-AzVMConfig. Andere Cmdlets können verwendet werden, um den virtuellen Computer zu konfigurieren, z. B. Set-AzVMOperatingSystem, Set-AzVMSourceImage und Add-AzVMNetworkInterface.

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

-VmssId

Die ID des Skalierungssatzes für den virtuellen Computer, mit dem diese VM verknüpft ist

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

-Zone

Gibt die Zonenliste des virtuellen Computers an.

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

Eingaben

String

PSVirtualMachine

String[]

Hashtable

Ausgaben

PSAzureOperationResponse