New-AzVMConfig

Referentie

Module:: Az.Compute

Hiermee maakt u een configureerbaar object voor virtuele machines.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

New-AzVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-Zone <String[]>]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-MaxPrice <Double>]
   [-EvictionPolicy <String>]
   [-Priority <String>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-EncryptionAtHost]
   [-CapacityReservationGroupId <String>]
   [-ImageReferenceId <String>]
   [-UserData <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-IdentityType] <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-Zone <String[]>]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-MaxPrice <Double>]
   [-EvictionPolicy <String>]
   [-Priority <String>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-EncryptionAtHost]
   [-CapacityReservationGroupId <String>]
   [-ImageReferenceId <String>]
   [-UserData <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Met de cmdlet New-AzVMConfig maakt u een configureerbaar lokaal vm-object voor Azure. Andere cmdlets kunnen worden gebruikt om een virtuele-machineobject te configureren, zoals Set-AzVMOperatingSystem, Set-AzVMSourceImage, Add-AzVMNetworkInterface en Set-AzVMOSDisk.

Voorbeelden

Voorbeeld 1: Een object voor een virtuele machine maken

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailabilitySet03 opgehaald in de resourcegroep ResourceGroup11 en wordt dat object vervolgens opgeslagen in de $AvailabilitySet variabele. Met de tweede opdracht wordt een virtuele-machineobject gemaakt en vervolgens opgeslagen in de $VirtualMachine variabele. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. De virtuele machine behoort tot de beschikbaarheidsset die is opgeslagen in $AvailabilitySet.

Parameters

-AvailabilitySetId

Hiermee geeft u de id van een beschikbaarheidsset. Gebruik de cmdlet Get-AzAvailabilitySet om een beschikbaarheidssetobject te verkrijgen. Het object beschikbaarheidsset bevat een id-eigenschap.
Virtuele machines die zijn opgegeven in dezelfde beschikbaarheidsset, worden toegewezen aan verschillende knooppunten om de beschikbaarheid te maximaliseren.
Zie De beschikbaarheid van virtuele machines beheren voor meer informatie over beschikbaarheidssets.
Zie Gepland onderhoud voor virtuele machines in Azure voor meer informatie over gepland Azure-onderhoud
Op dit moment kan een VIRTUELE machine alleen worden toegevoegd aan de beschikbaarheidsset tijdens het maken. De beschikbaarheidsset waaraan de VIRTUELE machine wordt toegevoegd, moet zich onder dezelfde resourcegroep bevinden als de beschikbaarheidssetresource. Een bestaande VM kan niet worden toegevoegd aan een beschikbaarheidsset.
Deze eigenschap kan niet bestaan samen met een verwijzing naar niet-null properties.virtualMachineScaleSet.

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

-CapacityReservationGroupId

Id van de capaciteitsreserveringsgroep die wordt gebruikt om toe te wijzen.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

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

-EnableUltraSSD

Hiermee kunt u een of meer beheerde gegevensschijven met UltraSSD_LRS opslagaccounttype op de virtuele machine hebben. Beheerde schijven met het type opslagaccount UltraSSD_LRS kunnen alleen worden toegevoegd aan een virtuele machine als deze eigenschap is ingeschakeld.

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

-EncryptionAtHost

De eigenschap EncryptionAtHost kan door de gebruiker in de aanvraag worden gebruikt om de hostversleuteling voor de virtuele machine of virtuele-machineschaalset in of uit te schakelen. Hierdoor wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource-/tijdelijke schijf op de host zelf. Standaard: De versleuteling op de host wordt uitgeschakeld, tenzij deze eigenschap is ingesteld op true voor de resource.

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

-EvictionPolicy

Het verwijderingsbeleid voor de virtuele Azure Spot-machine. Ondersteunde waarden zijn 'Toewijzing ongedaan maken' en 'Verwijderen'.

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

-HibernationEnabled

De vlag waarmee de sluimerstand op de VIRTUELE machine wordt ingeschakeld of uitgeschakeld.

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

-HostId

De id van de host

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

-IdentityId

Hiermee geeft u de lijst met gebruikersidentiteiten die zijn gekoppeld aan de virtuele-machineschaalset. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

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

-IdentityType

De identiteit van de virtuele machine, indien geconfigureerd.

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	4
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceId

De unieke id voor de installatiekopieën van de gedeelde galerie opgegeven voor vm-implementatie. Dit kan worden opgehaald uit de GET-aanroep van de installatiekopieën in de gedeelde galerie.

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

-LicenseType

Hiermee geeft u een licentietype op dat aangeeft dat de installatiekopie of schijf voor de virtuele machine on-premises is gelicentieerd. Mogelijke waarden voor Windows Server zijn:

Windows_Client
Windows_Server

Mogelijke waarden voor het Linux Server-besturingssysteem zijn:

RHEL_BYOS (voor RHEL)
SLES_BYOS (voor SUSE)

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

-MaxPrice

Hiermee geeft u de maximale prijs die u wilt betalen voor een VM/VMSS met lage prioriteit. Deze prijs is in Amerikaanse dollars. Deze prijs wordt vergeleken met de huidige prijs met lage prioriteit voor de VM-grootte. De prijzen worden ook vergeleken op het moment van maken/bijwerken van VM/VMSS met lage prioriteit en de bewerking slaagt alleen als de maxPrice groter is dan de huidige prijs met lage prioriteit. De maxPrice wordt ook gebruikt voor het verwijderen van een VM/VMSS met lage prioriteit als de huidige prijs met lage prioriteit hoger is dan de maxPrice na het maken van VM/VMSS. Mogelijke waarden zijn: elke decimale waarde die groter is dan nul. Voorbeeld: 0.01538. -1 geeft aan dat de VM/VMSS met lage prioriteit niet om prijsredenen mag worden verwijderd. De standaard maximumprijs is -1 als deze niet door u wordt verstrekt.

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

-PlatformFaultDomain

Hiermee geeft u het foutdomein van de virtuele machine.

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

-Priority

De prioriteit voor de virtuele machine. Alleen ondersteunde waarden zijn 'Regular', 'Spot' en 'Low'. 'Normaal' is voor reguliere virtuele machine. Spot is voor spot-VM. 'Laag' is ook bedoeld voor spot-VM's, maar wordt vervangen door Spot. Gebruik Spot in plaats van 'Laag'.

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

-ProximityPlacementGroupId

De resource-id van de nabijheidsplaatsingsgroep die met deze virtuele machine moet worden gebruikt.

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

-Tags

De tags die aan de resource zijn gekoppeld.

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

-UserData

UserData voor de VM, die wordt gecodeerd met base-64. Klant mag hier geen geheimen doorgeven.

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

-vCPUCountAvailable

Hiermee geeft u het aantal vCPU's op dat beschikbaar is voor de virtuele machine. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, is het standaardgedrag om deze in te stellen op de waarde van vCPU's die beschikbaar zijn voor die VM-grootte die beschikbaar is in api-antwoord van De lijst met alle beschikbare vm-grootten in een regio.

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

-vCPUCountPerCore

Hiermee geeft u de verhouding tussen vCPU en fysieke kern. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, wordt het standaardgedrag ingesteld op de waarde van vCPUUsPerCore voor de VM-grootte die wordt weergegeven in api-antwoord van de lijst met alle beschikbare vm-grootten in een regio. Als u deze eigenschap instelt op 1, betekent dit ook dat hyperthreading is uitgeschakeld.

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

-VMName

Hiermee geeft u een naam voor de virtuele machine.

Type:	String
Aliases:	ResourceName, Name
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMSize

Hiermee geeft u de grootte voor de virtuele machine.

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

-VmssId

De id van virtuele-machineschaalset

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

-Zone

Hiermee geeft u de lijst met beschikbaarheidszones voor de virtuele machine op. De toegestane waarden zijn afhankelijk van de mogelijkheden van de regio. Toegestane waarden zijn normaal gesproken 1,2,3.

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

Invoerwaarden

String

String[]

Hashtable

SwitchParameter

Uitvoerwaarden

PSVirtualMachine