Set-AzureRmVMOSDisk
Beállítja egy operációsrendszer-lemez tulajdonságait egy virtuális gépen.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
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
A Set-AzureRmVMOSDisk parancsmag beállítja az operációsrendszer-lemez tulajdonságait egy virtuális gépen.
Példák
1. példa: Tulajdonságok beállítása egy virtuális gépen platformrendszerképből
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"Az első parancs lekéri az AvailablitySet13 nevű rendelkezésre állási csoportot a ResourceGroup11 nevű erőforráscsoportban, majd az objektumot a $AvailabilitySet változóban tárolja. A második parancs létrehoz egy virtuálisgép-objektumot, majd a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A virtuális gép a $AvailabilitySet tárolt rendelkezésre állási csoporthoz tartozik. Az utolsó parancs beállítja a tulajdonságokat a virtuális gépen a $VirtualMachine.
2. példa: Egy virtuális gép tulajdonságainak beállítása általánosított felhasználói rendszerképből
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"Az első parancs lekéri az AvailablitySet13 nevű rendelkezésre állási csoportot a ResourceGroup11 nevű erőforráscsoportban, és az objektumot a $AvailabilitySet változóban tárolja. A második parancs létrehoz egy virtuálisgép-objektumot, és a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A virtuális gép a $AvailabilitySet tárolt rendelkezésre állási csoporthoz tartozik. Az utolsó parancs beállítja a tulajdonságokat a virtuális gépen a $VirtualMachine.
3. példa: Tulajdonságok beállítása egy virtuális gépen speciális felhasználói rendszerképből
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"Az első parancs lekéri az AvailablitySet13 nevű rendelkezésre állási csoportot a ResourceGroup11 nevű erőforráscsoportban, és az objektumot a $AvailabilitySet változóban tárolja. A második parancs létrehoz egy virtuálisgép-objektumot, és a $VirtualMachine változóban tárolja. A parancs nevet és méretet rendel a virtuális géphez. A virtuális gép a $AvailabilitySet tárolt rendelkezésre állási csoporthoz tartozik. Az utolsó parancs beállítja a tulajdonságokat a virtuális gépen a $VirtualMachine.
4. példa: A lemeztitkosítási beállítások beállítása egy virtuális gép operációsrendszer-lemezén
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"Ez a példa egy virtuális gép operációsrendszer-lemezén állítja be a lemeztitkosítási beállításokat.
Paraméterek
-Caching
Az operációsrendszer-lemez gyorsítótárazási módját adja meg. Az érvényes értékek a következők:
- Olvasás
- ReadWrite Az alapértelmezett érték a ReadWrite. A gyorsítótárazás értékének módosítása miatt a virtuális gép újraindul. Ez a beállítás hatással van a lemez teljesítményére.
| Típus: | Nullable<T>[CachingTypes] |
| Elfogadott értékek: | None, ReadOnly, ReadWrite |
| Position: | 3 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-CreateOption
Megadja, hogy ez a parancsmag létrehoz-e egy lemezt a virtuális gépen egy platformról vagy egy felhasználói lemezképből, vagy csatol egy meglévő lemezt. Az érvényes értékek a következők:
- Csatolja. Ezzel a beállítással speciális lemezről hozhat létre virtuális gépet. Ha ezt a beállítást adja meg, ne adja meg a SourceImageUri paramétert. Ehelyett használja a Set-AzureRmVMSourceImage parancsmagot. A Windows vagy Linux paraméterek használatával is meg kell adnia az Azure-platformnak a VHD operációs rendszerének típusát. A VhdUri paraméter elegendő ahhoz, hogy az Azure-platformnak meg tudja mondani a csatolandó lemez helyét.
- FromImage. Ezzel a beállítással virtuális gépet hozhat létre platformrendszerképből vagy általánosított felhasználói rendszerképből. Általánosított felhasználói rendszerkép esetén a SourceImageUri paramétert és a Windows vagy Linux paramétereket is meg kell adnia, hogy a Set-AzureRmVMSourceImage parancsmag használata helyett az Azure-platformnak meg kell adnia az operációsrendszer-lemez VHD-jének helyét és típusát. Platformrendszerkép esetén a VhdUri paraméter elegendő.
- Üres.
| Típus: | String |
| Position: | 5 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
| Típus: | IAzureContextContainer |
| Aliasok: | AzureRmContext, AzureCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DiffDiskSetting
Az operációsrendszer-lemez eltérő lemezbeállításait adja meg.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-DiskEncryptionKeyUrl
Megadja a lemeztitkosítási kulcs helyét.
| Típus: | String |
| Position: | 7 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DiskEncryptionKeyVaultId
Megadja a lemeztitkosítási kulcsot tartalmazó Key Vault erőforrás-azonosítóját.
| Típus: | String |
| Position: | 8 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DiskSizeInGB
Az operációsrendszer-lemez méretét adja meg GB-ban.
| Típus: | Nullable<T>[Int32] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-KeyEncryptionKeyUrl
Megadja a kulcstitkosítási kulcs helyét.
| Típus: | String |
| Position: | 9 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-KeyEncryptionKeyVaultId
Megadja a kulcstitkosítási kulcsot tartalmazó Key Vault erőforrás-azonosítóját.
| Típus: | String |
| Position: | 10 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Linux
Azt jelzi, hogy a felhasználói lemezkép operációs rendszere Linux. Adja meg ezt a paramétert a felhasználói lemezképalapú virtuális gépek üzembe helyezéséhez.
| Típus: | SwitchParameter |
| Position: | 6 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ManagedDiskId
Egy felügyelt lemez azonosítóját adja meg.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Name
Az operációsrendszer-lemez nevét adja meg.
| Típus: | String |
| Aliasok: | OSDiskName, DiskName |
| Position: | 1 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-SourceImageUri
Megadja a VHD URI-ját a felhasználói rendszerkép-forgatókönyvekhez.
| Típus: | String |
| Aliasok: | SourceImage |
| Position: | 4 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-StorageAccountType
A felügyelt lemez tárfióktípusát adja meg.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-VhdUri
Egy virtuális merevlemez (VHD) egységes erőforrás-azonosítóját (URI) adja meg. Képalapú virtuális gépek esetén ez a paraméter határozza meg a platformrendszerkép vagy felhasználói rendszerkép megadásakor létrehozandó VHD-fájlt. Ez az a hely, ahonnan a rendszer átmásolja a lemezkép bináris nagyméretű objektumát (BLOB) a virtuális gép elindításához. Lemezalapú virtuálisgép-rendszerindítási forgatókönyv esetén ez a paraméter azt a VHD-fájlt adja meg, amelyet a virtuális gép közvetlenül használ az indításhoz.
| Típus: | String |
| Aliasok: | OSDiskVhdUri, DiskVhdUri |
| Position: | 2 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-VM
Megadja azt a helyi virtuálisgép-objektumot, amelyre az operációs rendszer lemeztulajdonságait be szeretné állítani. Virtuálisgép-objektum beszerzéséhez használja a Get-AzureRmVM parancsmagot.
| Típus: | PSVirtualMachine |
| Aliasok: | VMProfile |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Windows
Azt jelzi, hogy a felhasználói lemezkép operációs rendszere Windows.
| Típus: | SwitchParameter |
| Position: | 6 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WriteAccelerator
Megadja, hogy a WriteAccelerator engedélyezve legyen vagy le legyen tiltva az operációsrendszer-lemezen.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
Paraméterek: virtuális gép (ByValue)