New-AzVMConfig

Referens

Modul:: Az.Compute

Skapar ett konfigurerbart virtuellt datorobjekt.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Cmdleten New-AzVMConfig skapar ett konfigurerbart lokalt virtuellt datorobjekt för Azure. Andra cmdletar kan användas för att konfigurera ett virtuellt datorobjekt, till exempel Set-AzVMOperatingSystem, Set-AzVMSourceImage, Add-AzVMNetworkInterface och Set-AzVMOSDisk.

Exempel

Exempel 1: Skapa ett virtuellt datorobjekt

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

Det första kommandot hämtar tillgänglighetsuppsättningen med namnet AvailabilitySet03 i resursgruppen med namnet ResourceGroup11 och lagrar sedan objektet i variabeln $AvailabilitySet. Det andra kommandot skapar ett virtuellt datorobjekt och lagrar det sedan i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. Den virtuella datorn tillhör tillgänglighetsuppsättningen som lagras i $AvailabilitySet.

Parametrar

-AvailabilitySetId

Anger ID för en tillgänglighetsuppsättning. Om du vill hämta ett tillgänglighetsuppsättningsobjekt använder du cmdleten Get-AzAvailabilitySet. Tillgänglighetsuppsättningsobjektet innehåller en ID-egenskap.
Virtuella datorer som anges i samma tillgänglighetsuppsättning allokeras till olika noder för att maximera tillgängligheten.
Mer information om tillgänglighetsuppsättningar finns i Hantera tillgängligheten för virtuella datorer.
Mer information om planerat Azure-underhåll finns i Planerat underhåll för virtuella datorer i Azure
För närvarande kan en virtuell dator bara läggas till i tillgänglighetsuppsättningen när den skapas. Tillgänglighetsuppsättningen som den virtuella datorn läggs till i ska vara under samma resursgrupp som tillgänglighetsuppsättningsresursen. Det går inte att lägga till en befintlig virtuell dator i en tillgänglighetsuppsättning.
Den här egenskapen kan inte finnas tillsammans med en referens för properties.virtualMachineScaleSet som inte är null.

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

-CapacityReservationGroupId

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

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

-DefaultProfile

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

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

-EnableUltraSSD

Aktiverar en funktion för att ha en eller flera hanterade datadiskar med UltraSSD_LRS lagringskontotyp på den virtuella datorn. Hanterade diskar med lagringskontotyp UltraSSD_LRS kan bara läggas till på en virtuell dator om den här egenskapen är aktiverad.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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/temporär 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.

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

-EvictionPolicy

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

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

-HibernationEnabled

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

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

-HostId

Värdens ID

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

-IdentityId

Anger listan över användaridentiteter som är associerade med VM-skalningsuppsättningen. Referenserna för användaridentiteten är ARM-resurs-ID:n i formatet: '/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

Identiteten för den virtuella datorn, om den har konfigurerats.

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

-ImageReferenceId

Det delade galleriavbildningens unika ID har angetts för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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)

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

-MaxPrice

Anger det högsta pris som du är villig att betala för en virtuell dator/VMSS med låg prioritet. Det här priset är i us-dollar. Det här priset jämförs med det aktuella lågprioriteringspriset för VM-storleken. Dessutom jämförs priserna vid tidpunkten för skapande/uppdatering av virtuell dator/VMSS med låg prioritet och åtgärden lyckas bara om maxPrice är större än det aktuella lågprioritetspriset. MaxPrice kommer också att användas för att ta bort en virtuell dator/VMSS med låg prioritet om det aktuella lågprioritetspriset överskrider maxPrice efter skapandet av VM/VMSS. Möjliga värden är: ett decimalvärde som är större än noll. Exempel: 0.01538. -1 anger att den virtuella datorn/VMSS med låg prioritet inte ska avlägsnas av prisskäl. Dessutom är det högsta standardpriset -1 om det inte tillhandahålls av dig.

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

-PlatformFaultDomain

Anger feldomänen för den virtuella datorn.

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

-Priority

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

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

-ProximityPlacementGroupId

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

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

-Tags

Taggarna som är kopplade till resursen.

Type:	Hashtable
Aliases:	Tag
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-vCPUCountAvailable

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

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

-vCPUCountPerCore

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

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

-VMName

Anger ett namn för den virtuella datorn.

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

-VMSize

Anger storleken på den virtuella datorn.

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

-VmssId

ID för VM-skalningsuppsättning

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

-Zone

Anger tillgänglighetszonlistan för den virtuella datorn. Vilka värden som tillåts beror på regionens funktioner. Tillåtna värden är normalt 1,2,3.

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

Indata

String

String[]

Hashtable

SwitchParameter

Utdata

PSVirtualMachine