Set-AzureRmVMOSDisk

Referenz

Modul:: AzureRM.Compute

Legt die Eigenschaften des Betriebssystemdatenträgers eines virtuellen Computers fest

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Das Cmdlet Set-AzureRmVMOSDisk legt die Eigenschaften des Betriebssystemdatenträgers auf einem virtuellen Computer fest.

Beispiele

Beispiel 1: Festlegen von Eigenschaften auf einem virtuellen Computer aus dem Plattformimage

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"

Der erste Befehl ruft den Verfügbarkeitssatz "AvailablitySet13" in der Ressourcengruppe "ResourceGroup11" ab und speichert das Objekt dann in der $AvailabilitySet Variablen. Der zweite Befehl erstellt ein Objekt eines virtuellen Computers und speichert es dann in der $VirtualMachine Variablen. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Der virtuelle Computer gehört zu dem in $AvailabilitySet gespeicherten Verfügbarkeitssatz. Mit dem letzten Befehl werden die Eigenschaften auf dem virtuellen Computer in $VirtualMachine festgelegt.

Beispiel 2: Legt Eigenschaften auf einem virtuellen Computer aus einem generalisierten Benutzerimage fest.

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"

Der erste Befehl ruft den Verfügbarkeitssatz "AvailablitySet13" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt in der $AvailabilitySet Variablen. Der zweite Befehl erstellt ein Objekt des virtuellen Computers und speichert es in der variablen $VirtualMachine. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Der virtuelle Computer gehört zu dem in $AvailabilitySet gespeicherten Verfügbarkeitssatz. Mit dem letzten Befehl werden die Eigenschaften auf dem virtuellen Computer in $VirtualMachine festgelegt.

Beispiel 3: Legt Eigenschaften auf einem virtuellen Computer aus einem speziellen Benutzerimage fest.

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"

Beispiel 4: Festlegen der Datenträgerverschlüsselungseinstellungen auf einem Betriebssystemdatenträger des virtuellen Computers

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 diesem Beispiel werden die Datenträgerverschlüsselungseinstellungen auf einem Betriebssystemdatenträger des virtuellen Computers festgelegt.

Parameter

-Caching

Gibt den Cachemodus des Betriebssystemdatenträgers an. Gültige Werte sind:

ReadOnly
ReadWrite Der Standardwert ist ReadWrite. Wenn Sie den Cachewert ändern, wird der virtuelle Computer neu gestartet. Diese Einstellung wirkt sich auf die Leistung des Datenträgers aus.

Typ:	Nullable<T>[CachingTypes]
Zulässige Werte:	None, ReadOnly, ReadWrite
Position:	3
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CreateOption

Gibt an, ob dieses Cmdlet einen Datenträger auf dem virtuellen Computer über eine Plattform oder ein Benutzerimage erstellt oder einen vorhandenen Datenträger anfügt. Gültige Werte sind:

Anfügen. Geben Sie diese Option an, um einen virtuellen Computer von einem speziellen Datenträger zu erstellen. Wenn Sie diese Option angeben, geben Sie nicht den SourceImageUri-Parameter an. Verwenden Sie stattdessen das Cmdlet Set-AzureRmVMSourceImage. Sie müssen auch die Windows- oder Linux-Parameter verwenden, um der Azure-Plattform den Typ des Betriebssystems auf der VHD mitzuteilen. Der VhdUri-Parameter reicht aus, um der Azure-Plattform den Speicherort des anzufügenden Datenträgers mitzuteilen.
Fromimage. Geben Sie diese Option an, um einen virtuellen Computer aus einem Plattformimage oder einem generalisierten Benutzerimage zu erstellen. Im Fall eines generalisierten Benutzerimages müssen Sie auch den Parameter "SourceImageUri" und entweder die Parameter "SourceImageUri" und "Windows" oder "Linux" angeben, um der Azure-Plattform den Speicherort und typ der VHD des Betriebssystemdatenträgers mitzuteilen, anstatt das Cmdlet Set-AzureRmVMSourceImage zu verwenden. Bei einem Plattformimage ist der VhdUri-Parameter ausreichend.
Leer.

Typ:	String
Position:	5
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DiffDiskSetting

Gibt die unterschiedlichen Datenträgereinstellungen für den Betriebssystemdatenträger an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DiskEncryptionKeyUrl

Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an.

Typ:	String
Position:	7
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DiskEncryptionKeyVaultId

Gibt die Ressourcen-ID des Key Vault an, der den Datenträgerverschlüsselungsschlüssel enthält.

Typ:	String
Position:	8
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DiskSizeInGB

Gibt die Größe des Betriebssystemdatenträgers in GB an.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyEncryptionKeyUrl

Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels an.

Typ:	String
Position:	9
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyEncryptionKeyVaultId

Gibt die Ressourcen-ID des Schlüsseltresors an, der den Schlüsselverschlüsselungsschlüssel enthält.

Typ:	String
Position:	10
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Linux

Gibt an, dass das Betriebssystem auf dem Benutzerimage Linux ist. Geben Sie diesen Parameter für die Bereitstellung von benutzerimagebasierten virtuellen Computern an.

Typ:	SwitchParameter
Position:	6
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskId

Gibt die ID eines verwalteten Datenträgers an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Gibt den Namen des Betriebssystemdatenträgers an.

Typ:	String
Aliase:	OSDiskName, DiskName
Position:	1
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SourceImageUri

Gibt den URI der VHD für Benutzerbildszenarien an.

Typ:	String
Aliase:	SourceImage
Position:	4
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StorageAccountType

Gibt den Speicherkontotyp des verwalteten Datenträgers an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VhdUri

Gibt den URI (Uniform Resource Identifier) einer virtuellen Festplatte (VHD) an. Für einen imagebasierten virtuellen Computer gibt dieser Parameter die VHD-Datei an, die erstellt werden soll, wenn ein Plattformimage oder Benutzerimage angegeben wird. Dies ist der Speicherort, von dem das binäre große Objekt (BLOB) des Images kopiert wird, um den virtuellen Computer zu starten. Für ein datenträgerbasiertes Startszenario für virtuelle Computer gibt dieser Parameter die VHD-Datei an, die der virtuelle Computer direkt zum Starten verwendet.

Typ:	String
Aliase:	OSDiskVhdUri, DiskVhdUri
Position:	2
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VM

Gibt das objekt des lokalen virtuellen Computers an, auf dem die Eigenschaften des Betriebssystemdatenträgers festgelegt werden sollen. Verwenden Sie das Cmdlet Get-AzureRmVM, um ein Objekt eines virtuellen Computers abzurufen.

Typ:	PSVirtualMachine
Aliase:	VMProfile
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Windows

Gibt an, dass das Betriebssystem auf dem Benutzerimage Windows ist.

Typ:	SwitchParameter
Position:	6
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WriteAccelerator

Gibt an, ob WriteAccelerator auf dem Betriebssystemdatenträger aktiviert oder deaktiviert werden soll.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

PSVirtualMachine

Parameter: VM (ByValue)

Ausgaben

PSVirtualMachine

Freigeben über

Set-AzureRmVMOSDisk

Syntax

Beschreibung

Beispiele

Beispiel 1: Festlegen von Eigenschaften auf einem virtuellen Computer aus dem Plattformimage

Beispiel 2: Legt Eigenschaften auf einem virtuellen Computer aus einem generalisierten Benutzerimage fest.

Beispiel 3: Legt Eigenschaften auf einem virtuellen Computer aus einem speziellen Benutzerimage fest.

Beispiel 4: Festlegen der Datenträgerverschlüsselungseinstellungen auf einem Betriebssystemdatenträger des virtuellen Computers

Parameter

-Caching

-CreateOption

-DefaultProfile

-DiffDiskSetting

-DiskEncryptionKeyUrl

-DiskEncryptionKeyVaultId

-DiskSizeInGB

-KeyEncryptionKeyUrl

-KeyEncryptionKeyVaultId

-Linux

-ManagedDiskId

-Name

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-Windows

-WriteAccelerator

Eingaben

Ausgaben

Zusätzliche Ressourcen

Freigeben über

Set-AzureRmVMOSDisk

Syntax

Beschreibung

Beispiele

Beispiel 1: Festlegen von Eigenschaften auf einem virtuellen Computer aus dem Plattformimage

Beispiel 2: Legt Eigenschaften auf einem virtuellen Computer aus einem generalisierten Benutzerimage fest.

Beispiel 3: Legt Eigenschaften auf einem virtuellen Computer aus einem speziellen Benutzerimage fest.

Beispiel 4: Festlegen der Datenträgerverschlüsselungseinstellungen auf einem Betriebssystemdatenträger des virtuellen Computers

Parameter

-Caching

-CreateOption

-DefaultProfile

-DiffDiskSetting

-DiskEncryptionKeyUrl

-DiskEncryptionKeyVaultId

-DiskSizeInGB

-KeyEncryptionKeyUrl

-KeyEncryptionKeyVaultId

-Linux

-ManagedDiskId

-Name

-SourceImageUri

-StorageAccountType

-VhdUri

-VM

-Windows

-WriteAccelerator

Eingaben

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen