Share via


Set-AzureRmVMOSDisk

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

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Windows]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-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>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-VM] <PSVirtualMachine>
   [[-Name] <String>]
   [[-VhdUri] <String>]
   [[-Caching] <CachingTypes>]
   [[-SourceImageUri] <String>]
   [[-CreateOption] <String>]
   [-Linux]
   [-DiskSizeInGB <Int32>]
   [-ManagedDiskId <String>]
   [-StorageAccountType <String>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmVMOSDisk
   [-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>]
   [-WriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

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

Voorbeelden

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

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
PS C:\> Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "OsDisk12" -VhdUri "os.vhd" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential) 
PS C:\> $VirtualMachine = Set-AzureRmVMSourceImage -VM $VirtualMachine -PublisherName "Canonical" -Offer "UbuntuServer" -Skus "15.10" -Version "latest" -Caching ReadWrite
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption FromImage
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailablitySet13 opgehaald in de resourcegroep ResourceGroup11 en wordt dat object vervolgens opgeslagen in de variabele $AvailabilitySet. Met de tweede opdracht wordt een object van een virtuele machine 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 op een virtuele machine in op basis van een gegeneraliseerde gebruikersinstallatiekopieën

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Linux -ComputerName "MainComputer" -Credential (Get-Credential)
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -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
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailablitySet13 opgehaald in de resourcegroep met de naam ResourceGroup11 en wordt dat object opgeslagen in de variabele $AvailabilitySet. Met de tweede opdracht wordt een object van een virtuele machine 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 op een virtuele machine in op basis van een gespecialiseerde gebruikersinstallatiekopieën

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet13" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:\> $VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name "osDisk.vhd" -VhdUri "https://mystorageaccount.blob.core.windows.net/disks/" -CreateOption Attach -Linux
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName "ResourceGroup11"

Met de eerste opdracht wordt de beschikbaarheidsset met de naam AvailablitySet13 opgehaald in de resourcegroep met de naam ResourceGroup11 en wordt dat object opgeslagen in de variabele $AvailabilitySet. Met de tweede opdracht wordt een object van een virtuele machine 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 schijfversleutelingsinstellingen instellen op een besturingssysteemschijf van een virtuele machine

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine17" -VMSize "Standard_A1"
PS C:> $VirtualMachine = Set-AzureRmVMOSDisk -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"
PS C:> New-AzureRmVM -VM $VirtualMachine -ResouceGroupName " 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:

  • Alleen-lezen
  • 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
Required:False
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, moet u de parameter SourceImageUri niet opgeven. Gebruik in plaats daarvan de cmdlet Set-AzureRmVMSourceImage. U moet ook de Windows- of Linux-parameters gebruiken om aan het Azure-platform het type besturingssysteem op de VHD te vertellen. 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 set-AzureRmVMSourceImage-cmdlet te gebruiken. In het geval van een platforminstallatiekopieën is de VhdUri-parameter voldoende.
  • Lege.
Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

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

-DiffDiskSetting

Hiermee geeft u de differentiërende schijfinstellingen voor besturingssysteemschijf.

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

-DiskEncryptionKeyUrl

Hiermee geeft u de locatie van de schijfversleutelingssleutel.

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

-DiskEncryptionKeyVaultId

Hiermee geeft u de resource-id van de sleutelkluis die de schijfversleutelingssleutel bevat.

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

-KeyEncryptionKeyUrl

Hiermee geeft u de locatie van de sleutelversleutelingssleutel.

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

-KeyEncryptionKeyVaultId

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

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

-VM

Hiermee geeft u het lokale virtuele-machineobject op waarop de schijfeigenschappen van het besturingssysteem moeten worden ingesteld. Gebruik de cmdlet Get-AzureRmVM om een object voor een virtuele machine te verkrijgen.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSVirtualMachine

Parameters: VM (ByValue)

Uitvoerwaarden

PSVirtualMachine