Dela via


Set-AzureRmVMOSDisk

Anger operativsystemets diskegenskaper på en virtuell dator.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Set-AzureRmVMOSDisk anger operativsystemets diskegenskaper på en virtuell dator.

Exempel

Exempel 1: Ange egenskaper på en virtuell dator från plattformsavbildning

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"

Det första kommandot hämtar tillgänglighetsuppsättningen med namnet AvailablitySet13 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. Det sista kommandot anger egenskaperna på den virtuella datorn i $VirtualMachine.

Exempel 2: Anger egenskaper på en virtuell dator från generaliserad användaravbildning

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"

Det första kommandot hämtar tillgänglighetsuppsättningen med namnet AvailablitySet13 i resursgruppen med namnet ResourceGroup11 och lagrar objektet i variabeln $AvailabilitySet. Det andra kommandot skapar ett virtuellt datorobjekt och lagrar det 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. Det sista kommandot anger egenskaperna på den virtuella datorn i $VirtualMachine.

Exempel 3: Anger egenskaper på en virtuell dator från en specialiserad användaravbildning

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"

Det första kommandot hämtar tillgänglighetsuppsättningen med namnet AvailablitySet13 i resursgruppen med namnet ResourceGroup11 och lagrar objektet i variabeln $AvailabilitySet. Det andra kommandot skapar ett virtuellt datorobjekt och lagrar det 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. Det sista kommandot anger egenskaperna på den virtuella datorn i $VirtualMachine.

Exempel 4: Ange inställningar för diskkryptering på en virtuell dators operativsystemdisk

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"

I det här exemplet anges diskkrypteringsinställningarna på en virtuell dators operativsystemdisk.

Parametrar

-Caching

Anger cachelagringsläget för operativsystemdisken. Giltiga värden är:

  • Skrivskyddat
  • ReadWrite Standardvärdet är ReadWrite. Om du ändrar cachelagringsvärdet startas den virtuella datorn om. Den här inställningen påverkar diskens prestanda.
Typ:Nullable<T>[CachingTypes]
Godkända värden:None, ReadOnly, ReadWrite
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CreateOption

Anger om den här cmdleten skapar en disk på den virtuella datorn från en plattform eller användarbild eller kopplar en befintlig disk. Giltiga värden är:

  • Bifoga. Ange det här alternativet för att skapa en virtuell dator från en specialiserad disk. När du anger det här alternativet ska du inte ange parametern SourceImageUri . Använd i stället cmdleten Set-AzureRmVMSourceImage. Du måste också använda parametrarna Windows eller Linux för att tala om för Azure-plattformen vilken typ av operativsystem som finns på den virtuella hårddisken. VhdUri-parametern räcker för att tala om för azure-plattformen var disken ska anslutas.
  • FromImage. Ange det här alternativet för att skapa en virtuell dator från en plattformsbild eller en generaliserad användarbild. När det gäller en generaliserad användaravbildning måste du också ange parametern SourceImageUri och antingen Windows - eller Linux-parametrarna för att tala om för Azure-plattformen platsen och typen av operativsystemdiskens VHD i stället för att använda cmdleten Set-AzureRmVMSourceImage . När det gäller en plattformsbild räcker det med VhdUri-parametern .
  • Tom.
Typ:String
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiffDiskSetting

Anger inställningarna för olika diskar för operativsystemdisken.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DiskEncryptionKeyUrl

Anger platsen för diskkrypteringsnyckeln.

Typ:String
Position:7
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskEncryptionKeyVaultId

Anger resurs-ID för nyckelvalvet som innehåller diskkrypteringsnyckeln.

Typ:String
Position:8
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskSizeInGB

Anger storleken i GB på operativsystemdisken.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-KeyEncryptionKeyUrl

Anger platsen för nyckelkrypteringsnyckeln.

Typ:String
Position:9
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-KeyEncryptionKeyVaultId

Anger resurs-ID för nyckelvalvet som innehåller nyckelkrypteringsnyckeln.

Typ:String
Position:10
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Linux

Anger att operativsystemet på användaravbildningen är Linux. Ange den här parametern för distribution av användarbildbaserade virtuella datorer.

Typ:SwitchParameter
Position:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ManagedDiskId

Anger ID för en hanterad disk.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på operativsystemdisken.

Typ:String
Alias:OSDiskName, DiskName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SourceImageUri

Anger URI för den virtuella hårddisken för användarbildscenarier.

Typ:String
Alias:SourceImage
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StorageAccountType

Anger lagringskontotypen för hanterad disk.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VhdUri

Anger URI (Uniform Resource Identifier) för en virtuell hårddisk (VHD). För en avbildningsbaserad virtuell dator anger den här parametern den VHD-fil som ska skapas när en plattformsbild eller användarbild anges. Det här är den plats från vilken det binära stora avbildningsobjektet (BLOB) kopieras för att starta den virtuella datorn. För ett diskbaserat startscenario för virtuella datorer anger den här parametern den VHD-fil som den virtuella datorn använder direkt för att starta.

Typ:String
Alias:OSDiskVhdUri, DiskVhdUri
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VM

Anger det lokala virtuella datorobjekt som du vill ange operativsystemdiskegenskaper på. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzureRmVM.

Typ:PSVirtualMachine
Alias:VMProfile
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Windows

Anger att operativsystemet på användaravbildningen är Windows.

Typ:SwitchParameter
Position:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WriteAccelerator

Anger om WriteAccelerator ska aktiveras eller inaktiveras på OS-disken.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSVirtualMachine

Parametrar: Virtuell dator (ByValue)

Utdata

PSVirtualMachine