Share via


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.
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

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-DiffDiskSetting

Az operációsrendszer-lemez eltérő lemezbeállításait adja meg.

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

-DiskEncryptionKeyUrl

Megadja a lemeztitkosítási kulcs helyét.

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

-DiskEncryptionKeyVaultId

Megadja a lemeztitkosítási kulcsot tartalmazó Key Vault erőforrás-azonosítóját.

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

-DiskSizeInGB

Az operációsrendszer-lemez méretét adja meg GB-ban.

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

-KeyEncryptionKeyUrl

Megadja a kulcstitkosítási kulcs helyét.

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

-KeyEncryptionKeyVaultId

Megadja a kulcstitkosítási kulcsot tartalmazó Key Vault erőforrás-azonosítóját.

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

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

-ManagedDiskId

Egy felügyelt lemez azonosítóját adja meg.

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

-Name

Az operációsrendszer-lemez nevét adja meg.

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

-SourceImageUri

Megadja a VHD URI-ját a felhasználói rendszerkép-forgatókönyvekhez.

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

-StorageAccountType

A felügyelt lemez tárfióktípusát adja meg.

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

Type:String
Aliases:OSDiskVhdUri, DiskVhdUri
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Windows

Azt jelzi, hogy a felhasználói lemezkép operációs rendszere Windows.

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

-WriteAccelerator

Megadja, hogy a WriteAccelerator engedélyezve legyen vagy le legyen tiltva az operációsrendszer-lemezen.

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

Bevitelek

PSVirtualMachine

Paraméterek: virtuális gép (ByValue)

Kimenetek

PSVirtualMachine