Set-AzVMOSDisk

Module:

Az.Compute

Hiermee stelt u de schijfeigenschappen van het besturingssysteem in voor een virtuele machine.

Notitie

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

Syntax

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskEncryptionKeyUrl] <String>
   [-DiskEncryptionKeyVaultId] <String>
   [[-KeyEncryptionKeyUrl] <String>]
   [[-KeyEncryptionKeyVaultId] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Met de cmdlet Set-AzVMOSDisk worden de eigenschappen van de besturingssysteemschijf op een virtuele machine ingesteld.

Voorbeelden

Voorbeeld 1: Eigenschappen instellen op een virtuele machine vanaf platforminstallatiekopieën

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential) 
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailabilitySet13 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. Met de laatste opdracht worden de eigenschappen op de virtuele machine in $VirtualMachine ingesteld.

Voorbeeld 2: Hiermee stelt u eigenschappen in op een virtuele machine op basis van een gegeneraliseerde gebruikersinstallatiekopieën

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -SourceImageUri "https://mystorageaccount.blob.core.windows.net/vhds/myOSImage.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption fromImage -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailabilitySet13 opgehaald in de resourcegroep ResourceGroup11 en wordt dat object opgeslagen in de $AvailabilitySet variabele. Met de tweede opdracht wordt een virtuele-machineobject gemaakt en 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. Met de laatste opdracht worden de eigenschappen op de virtuele machine in $VirtualMachine ingesteld.

Voorbeeld 3: Hiermee stelt u eigenschappen in op een virtuele machine op basis van een gespecialiseerde gebruikersinstallatiekopieën

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
New-AzVM -VM $VirtualMachine -ResourceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailabilitySet13 opgehaald in de resourcegroep ResourceGroup11 en wordt dat object opgeslagen in de $AvailabilitySet variabele. Met de tweede opdracht wordt een virtuele-machineobject gemaakt en 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. Met de laatste opdracht worden de eigenschappen op de virtuele machine in $VirtualMachine ingesteld.

Voorbeeld 4: De instellingen voor schijfversleuteling instellen op een besturingssysteemschijf van een virtuele machine

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite -Windows -CreateOption "Attach" -DiskEncryptionKeyUrl "https://mytestvault.vault.azure.net/secrets/Test1/514ceb769c984379a7e0230bddaaaaaa" -DiskEncryptionKeyVaultId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mytestvault"
New-AzVM -VM $VirtualMachine -ResourceGroupName " ResourceGroup11"

In dit voorbeeld worden de instellingen voor schijfversleuteling ingesteld op een besturingssysteemschijf van een virtuele machine.

Parameters

-Caching

Hiermee geeft u de cachemodus van de besturingssysteemschijf. Geldige waarden zijn:

• ReadOnly
• ReadWrite De standaardwaarde is ReadWrite. Als u de cachewaarde wijzigt, wordt de virtuele machine opnieuw opgestart. Deze instelling is van invloed op de prestaties van de schijf.

Type:	Nullable<T>[CachingTypes]
Accepted values:	None, ReadOnly, ReadWrite
Position:	3
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CreateOption

Hiermee geeft u op of met deze cmdlet een schijf in de virtuele machine wordt gemaakt op basis van een platform- of gebruikersinstallatiekopieën, of een bestaande schijf wordt gekoppeld. Geldige waarden zijn:

• Koppelen. Geef deze optie op om een virtuele machine te maken op basis van een gespecialiseerde schijf. Wanneer u deze optie opgeeft, geeft u de parameter SourceImageUri niet op. Gebruik in plaats daarvan de cmdlet Set-AzVMSourceImage. U moet ook de Windows- of Linux-parameters gebruiken om het Type van het besturingssysteem op de VHD door te geven aan het Azure-platform. De parameter VhdUri is voldoende om het Azure-platform de locatie van de schijf te laten koppelen.
• FromImage. Geef deze optie op om een virtuele machine te maken op basis van een platforminstallatiekopieën of een gegeneraliseerde gebruikersinstallatiekopieën. In het geval van een gegeneraliseerde gebruikersinstallatiekopie moet u ook de parameter SourceImageUri en de Windows - of Linux-parameters opgeven om het Azure-platform de locatie en het type van de VHD van de besturingssysteemschijf op te geven in plaats van de cmdlet Set-AzVMSourceImage te gebruiken. In het geval van een platforminstallatiekopieën is de VhdUri-parameter voldoende.
• Lege.

Type:	String
Position:	5
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

-DeleteOption

Hiermee geeft u de optie voor verwijderen van besturingssysteemschijf op nadat de VM is verwijderd. Opties zijn loskoppelen, verwijderen

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

-DiffDiskPlacement

Hiermee geeft u de tijdelijke schijfplaatsing voor de besturingssysteemschijf. Deze eigenschap kan door de gebruiker in de aanvraag worden gebruikt om de locatie te kiezen, bijvoorbeeld de cacheschijf of resourceschijfruimte voor tijdelijke inrichting van besturingssysteemschijven. Raadpleeg voor meer informatie over kortstondige besturingssysteemschijfgroottevereisten de vereisten voor kortstondige besturingssysteemschijfgrootte voor Windows-VM op https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements en Linux-VM op https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Deze parameter kan alleen worden gebruikt als de parameter DiffDiskSetting is ingesteld op Lokaal.

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

-DiffDiskSetting

Hiermee geeft u de differentiërende schijfinstellingen voor de besturingssysteemschijf.

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

-DiskEncryptionKeyUrl

Hiermee geeft u de locatie van de schijfversleutelingssleutel.

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

-DiskEncryptionKeyVaultId

Hiermee geeft u de resource-id van de Key Vault met de schijfversleutelingssleutel.

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

-DiskEncryptionSetId

Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset op. Dit kan alleen worden opgegeven voor beheerde schijf.

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

-DiskSizeInGB

Hiermee geeft u de grootte, in GB, van de besturingssysteemschijf.

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

-KeyEncryptionKeyUrl

Hiermee geeft u de locatie van de sleutelversleutelingssleutel.

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

-KeyEncryptionKeyVaultId

Hiermee geeft u de resource-id van de Key Vault die de sleutelversleutelingssleutel bevat.

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

-Linux

Geeft aan dat het besturingssysteem op de gebruikersinstallatiekopieën Linux is. Geef deze parameter op voor implementatie van virtuele machines op basis van gebruikersinstallatiekopieën.

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

-ManagedDiskId

Hiermee geeft u de id van een beheerde schijf.

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

-Name

Hiermee geeft u de naam van de besturingssysteemschijf.

Type:	String
Aliases:	OSDiskName, DiskName
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SourceImageUri

Hiermee geeft u de URI van de VHD voor scenario's met gebruikersinstallatiekopieën.

Type:	String
Aliases:	SourceImage
Position:	4
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountType

Hiermee geeft u het type opslagaccount van de beheerde schijf.

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

-VhdUri

Hiermee geeft u de URI (Uniform Resource Identifier) van een virtuele harde schijf (VHD). Voor een virtuele machine op basis van een installatiekopieën geeft deze parameter het VHD-bestand op dat moet worden gemaakt wanneer een platforminstallatiekopieën of gebruikersinstallatiekopieën worden opgegeven. Dit is de locatie waaruit het binaire grote object (BLOB) van de installatiekopieën wordt gekopieerd om de virtuele machine te starten. Voor een opstartscenario op basis van een virtuele machine op basis van een schijf geeft deze parameter het VHD-bestand op dat de virtuele machine rechtstreeks gebruikt voor het opstarten.

Type:	String
Aliases:	OSDiskVhdUri, DiskVhdUri
Position:	2
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Hiermee geeft u het lokale virtuele-machineobject op waarop de eigenschappen van de besturingssysteemschijf moeten worden ingesteld. Gebruik de cmdlet Get-AzVM om een object voor een virtuele machine op te halen.

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

-Windows

Geeft aan dat het besturingssysteem op de gebruikersinstallatiekopieën Windows is.

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

-WriteAccelerator

Hiermee geeft u op of WriteAccelerator moet worden ingeschakeld of uitgeschakeld op de besturingssysteemschijf.

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

Invoerwaarden

PSVirtualMachine

String

Uitvoerwaarden

PSVirtualMachine

Verwante koppelingen

• Get-AzVM
• Get-AzAvailabilitySet
• New-AzVMConfig