Set-AzureRmVMOSDisk
Nastaví vlastnosti disku s operačním systémem na virtuálním počítači.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
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
Rutina Set-AzureRmVMOSDisk nastaví vlastnosti disku operačního systému na virtuálním počítači.
Příklady
Příklad 1: Nastavení vlastností virtuálního počítače z image platformy
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"První příkaz získá skupinu dostupnosti s názvem AvailablitySet13 ve skupině prostředků s názvem ResourceGroup11 a pak tento objekt uloží do proměnné $AvailabilitySet. Druhý příkaz vytvoří objekt virtuálního počítače a pak ho uloží do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Virtuální počítač patří do skupiny dostupnosti uložené v $AvailabilitySet. Poslední příkaz nastaví vlastnosti virtuálního počítače v $VirtualMachine.
Příklad 2: Nastaví vlastnosti virtuálního počítače z generalizované uživatelské image.
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"První příkaz získá skupinu dostupnosti s názvem AvailablitySet13 ve skupině prostředků s názvem ResourceGroup11 a uloží tento objekt do proměnné $AvailabilitySet. Druhý příkaz vytvoří objekt virtuálního počítače a uloží ho do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Virtuální počítač patří do skupiny dostupnosti uložené v $AvailabilitySet. Poslední příkaz nastaví vlastnosti virtuálního počítače v $VirtualMachine.
Příklad 3: Nastaví vlastnosti na virtuálním počítači ze specializované image uživatele.
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"První příkaz získá skupinu dostupnosti s názvem AvailablitySet13 ve skupině prostředků s názvem ResourceGroup11 a uloží tento objekt do proměnné $AvailabilitySet. Druhý příkaz vytvoří objekt virtuálního počítače a uloží ho do proměnné $VirtualMachine. Příkaz přiřadí virtuálnímu počítači název a velikost. Virtuální počítač patří do skupiny dostupnosti uložené v $AvailabilitySet. Poslední příkaz nastaví vlastnosti virtuálního počítače v $VirtualMachine.
Příklad 4: Nastavení šifrování disku na disku s operačním systémem virtuálního počítače
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"Tento příklad nastaví nastavení šifrování disku na disku operačního systému virtuálního počítače.
Parametry
-Caching
Určuje režim ukládání do mezipaměti disku operačního systému. Platné hodnoty jsou:
- Jen pro čtení
- ReadWrite Výchozí hodnota je ReadWrite. Změna hodnoty ukládání do mezipaměti způsobí restartování virtuálního počítače. Toto nastavení má vliv na výkon disku.
| Typ: | Nullable<T>[CachingTypes] |
| Přípustné hodnoty: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-CreateOption
Určuje, jestli tato rutina vytvoří na virtuálním počítači disk z image platformy nebo uživatele nebo připojí existující disk. Platné hodnoty jsou:
- Připojit. Tuto možnost zadejte, pokud chcete vytvořit virtuální počítač ze specializovaného disku. Při zadání této možnosti nezadávejte parametr SourceImageUri . Místo toho použijte rutinu Set-AzureRmVMSourceImage. Musíte také použít parametry Windows nebo Linux k tomu, abyste platformě Azure řekli typ operačního systému na virtuálním pevného disku. Parametr VhdUri stačí k tomu, aby platformě Azure řekl umístění disku, který se má připojit.
- ZImage. Tuto možnost zadejte, pokud chcete vytvořit virtuální počítač z image platformy nebo generalizované uživatelské image. V případě zobecněné image uživatele musíte také zadat parametr SourceImageUri a parametry Windows nebo Linuxu , které platformě Azure sdělí umístění a typ virtuálního pevného disku operačního systému místo rutiny Set-AzureRmVMSourceImage . V případě image platformy stačí parametr VhdUri .
- Prázdné.
| Typ: | String |
| Position: | 5 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DiffDiskSetting
Určuje rozdílové nastavení disku pro disk operačního systému.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DiskEncryptionKeyUrl
Určuje umístění šifrovacího klíče disku.
| Typ: | String |
| Position: | 7 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DiskEncryptionKeyVaultId
Určuje ID prostředku služby Key Vault obsahující šifrovací klíč disku.
| Typ: | String |
| Position: | 8 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DiskSizeInGB
Určuje velikost disku operačního systému v GB.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-KeyEncryptionKeyUrl
Určuje umístění šifrovacího klíče klíče.
| Typ: | String |
| Position: | 9 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-KeyEncryptionKeyVaultId
Určuje ID prostředku služby Key Vault obsahující šifrovací klíč klíče.
| Typ: | String |
| Position: | 10 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Linux
Označuje, že operační systém na uživatelské imagi je Linux. Zadejte tento parametr pro nasazení virtuálního počítače založeného na imagi uživatele.
| Typ: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ManagedDiskId
Určuje ID spravovaného disku.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Určuje název disku operačního systému.
| Typ: | String |
| Aliasy: | OSDiskName, DiskName |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SourceImageUri
Určuje identifikátor URI virtuálního pevného disku pro scénáře image uživatele.
| Typ: | String |
| Aliasy: | SourceImage |
| Position: | 4 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-StorageAccountType
Určuje typ účtu úložiště spravovaného disku.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VhdUri
Určuje identifikátor URI (Uniform Resource Identifier) virtuálního pevného disku (VHD). U virtuálního počítače založeného na imagi určuje tento parametr soubor VHD, který se má vytvořit při zadání image platformy nebo uživatelské image. Toto je umístění, ze kterého se zkopíruje binární velký objekt image (BLOB) pro spuštění virtuálního počítače. Pro scénář spuštění virtuálního počítače založeného na disku určuje tento parametr soubor VHD, který virtuální počítač používá přímo ke spuštění.
| Typ: | String |
| Aliasy: | OSDiskVhdUri, DiskVhdUri |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VM
Určuje objekt místního virtuálního počítače, na kterém se mají nastavit vlastnosti disku operačního systému. K získání objektu virtuálního počítače použijte rutinu Get-AzureRmVM.
| Typ: | PSVirtualMachine |
| Aliasy: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Windows
Označuje, že operační systém na uživatelské imagi je Windows.
| Typ: | SwitchParameter |
| Position: | 6 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WriteAccelerator
Určuje, jestli má být na disku s operačním systémem povolený nebo zakázaný WriteAccelerator.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Parametry: Virtuální počítač (ByValue)