Convert-SCVirtualDiskDrive

Referenz

Modul:: VirtualMachineManager

Wandelt eine virtuelle Festplatte von dynamischer zu fester, von fester in dynamischer, von VHD in VHDX um oder konvertiert einen Pass-Through-Datenträger in eine virtuelle Festplatte.

Syntax

Convert-SCVirtualDiskDrive
       [-Fixed]
       [-VirtualDiskDrive] <VirtualDiskDrive>
       [-Path <String>]
       [-FileName <String>]
       [-VHDFormatType <VHDFormatType>]
       [-JobGroup <Guid>]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Convert-SCVirtualDiskDrive
       [-Dynamic]
       [-VirtualDiskDrive] <VirtualDiskDrive>
       [-Path <String>]
       [-FileName <String>]
       [-VHDFormatType <VHDFormatType>]
       [-JobGroup <Guid>]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Convert-SCVirtualDiskDrive
       [-VHDX]
       [-DeleteSource]
       [-ValidateOnCompletion]
       [-VirtualDiskDrive] <VirtualDiskDrive>
       [-Path <String>]
       [-FileName <String>]
       [-JobGroup <Guid>]
       [-BlockSizeBytes <Int32>]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Convert-SCVirtualDiskDrive konvertiert eine vorhandene virtuelle Festplatte, die an ein virtuelles Laufwerkobjekt angefügt ist, von dynamischen zu festen oder von festen zu dynamischen, von VHD in VHDX, oder konvertiert einen übergebenen Datenträger, der an ein virtuelles Datenträgerobjekt angefügt ist, in eine virtuelle Festplatte.

Um die virtuelle Festplatte von einem Format in das andere zu konvertieren, muss der virtuelle Computer, auf dem die virtuelle Festplatte konfiguriert ist, in einem beendeten Zustand sein.

Sie können nur das Datenträgerformat einer windowsbasierten VD-Datei auf einem virtuellen Computer konvertieren, der auf einem Hyper-V-Host bereitgestellt wird.

Eine VMware-basierte VMDK-Datei auf einem virtuellen Computer, der auf einem ESX-Host bereitgestellt wird, wird im Format behoben. Sie können es nicht in ein dynamisches Format konvertieren.

Eine citrix XenServer-basierte VHD-Datei auf einem virtuellen Computer, der auf einem Citrix XenServer-Host bereitgestellt wird, wird im Format behoben. Sie können es nicht in ein dynamisches Format konvertieren.

Sie können nur das Datenträgerformat einer windowsbasierten virtuellen Festplatte von VHD in VHD in VHD auf einem virtuellen Computer konvertieren, der auf einem Hyper-V-Host bereitgestellt wird. Um eine VHD in VHDX zu konvertieren, muss der virtuelle Computer, auf dem die virtuelle Festplatte konfiguriert ist, in einem beendeten Zustand sein.

Ein Pass-Through-Datenträger ist eine physische Festplatte auf dem Host, der von einer virtuellen Maschine anstelle einer virtuellen Festplatte verwendet werden kann. Dieses Cmdlet konvertiert einen Pass-Through-Datenträger, der an ein virtuelles Datenträgerlaufwerk auf einem virtuellen Computer angefügt ist, in eine virtuelle Festplatte. Der virtuelle Computer muss sich auf einem Hyper-V-Host befinden und muss in einem beendeten Zustand sein.

Beispiele

Beispiel 1: Konvertieren eines Pass-Through-Datenträgers auf einem virtuellen Computer in eine virtuelle Festplatte

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> Convert-VirtualDiskDrive $VirtDiskDrive -Fixed -Path "C:\VirtualDiskDrives"

Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 mithilfe des Cmdlets Get-SCVirtualMachine ab. Der Befehl speichert dieses Objekt in der $VM Variablen. In diesem Beispiel wird davon ausgegangen, dass VM01 derzeit für die Verwendung eines Pass-Through-Datenträgers konfiguriert ist und dass der virtuelle Computer nur einen Pass-Through-Datenträger aufweist.

Der zweite Befehl ruft das virtuelle Datenträgerlaufwerkobjekt auf VM01 ab und speichert dieses Objekt dann in der $VirtDiskDrive Variablen.

Der letzte Befehl konvertiert das in $VirtDiskDrive gespeicherte Laufwerk auf eine feste virtuelle Festplatte. Der Befehl verschiebt die virtuelle Festplatte in den Zielordner C:\VirtualDiskDrives.

Beispiel 2: Konvertieren einer von mehreren Pass-Through-Datenträgern auf einem virtuellen Datenträger auf einem virtuellen Computer in eine virtuelle Festplatte

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> $VirtDiskDrive[2] | Convert-SCVirtualDiskDrive -Dynamic -Path "D:\"

Der erste Befehl ruft das virtuelle Computerobjekt namens VM02 ab und speichert dieses Objekt dann in der $VM Variablen. In diesem Beispiel wird davon ausgegangen, dass VM02 drei virtuelle Datenträgerobjekte aufweist und dass das erste virtuelle Datenträgerlaufwerk an eine virtuelle Festplatte gebunden ist, während sowohl die zweiten als auch die dritten virtuellen Datenträgerlaufwerke an Pass-Through-Datenträger gebunden sind.

Der zweite Befehl ruft alle virtuellen Datenträgerlaufwerkobjekte auf VM02 ab, und speichert diese Objekte dann im $VirtDiskDrive-Objektarray.

Der letzte Befehl konvertiert den dritten Pass-Through-Datenträger, der das dritte Element des $VirtDiskDrive Arrays ist, in eine dynamisch erweiterte virtuelle Festplatte. Der Befehl bezieht sich auf diese neue virtuelle Festplatte auf den Zielordner D:.

Beispiel 3: Konvertieren einer dynamischen VHD an ein virtuelles Datenträgerlaufwerkobjekt auf einem virtuellen Computer in ein festes Format

PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM (Get-SCVirtualMachine -Name "VM03")
PS C:\> Convert-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive -Fixed

Der erste Befehl ruft das virtuelle Datenträgerlaufwerkobjekt ab, das an virtuelle Computer VM03 angefügt ist, und speichert dann das virtuelle Datenträgerlaufwerkobjekt in der $VirtDiskDrive Variable. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur ein virtuelles Laufwerkobjekt aufweist und dass die virtuelle Festplatte, die an das virtuelle Datenträger angefügt ist, eine dynamische virtuelle Festplatte ist.

Der zweite Befehl konvertiert die in $VirtDiskDrive gespeicherte virtuelle Festplatte in einen festen Datenträger.

Beispiel 4: Konvertieren einer dynamischen VHD auf einem virtuellen Computer in feste VHDX

PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM (Get-SCVirtualMachine -Name "VM03")
PS C:\> Convert-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive -VHDX

Der erste Befehl ruft das virtuelle Datenträgerlaufwerkobjekt ab, das an virtuellen Computer VM03 angefügt ist, und speichert dieses Objekt in der $VirtDiskDrive Variablen. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur ein virtuelles Laufwerkobjekt aufweist und dass die virtuelle Festplatte, die an das virtuelle Datenträger angefügt ist, eine dynamische virtuelle Festplatte ist. In diesem Beispiel wird auch davon ausgegangen, dass sich der virtuelle Computer in einem beendeten Zustand befindet.

Der zweite Befehl konvertiert die in $VirtDiskDrive gespeicherte virtuelle Festplatte in einen VHDX-Datenträger.

Beispiel 5: Konvertieren einer unterschiedlichen VHD in einen unterschiedlichen VHDX

PS C:\> $VirtDiskDrive = Get-VirtualDiskDrive -VM (Get-SCVirtualMachine -Name "VM04")
PS C:\> Convert-VirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive -VHDX -BlockSizeBytes 1MB -DeleteSource -ValidateOnCompletion

Der erste Befehl ruft das virtuelle Datenträgerlaufwerkobjekt ab, das an virtuellen Computer VM04 angefügt wird, und speichert dieses Objekt dann in der $VirtDiskDrive Variablen. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur ein virtuelles Laufwerkobjekt aufweist und dass die virtuelle Festplatte, die an das virtuelle Datenträger angefügt ist, eine dynamische virtuelle Festplatte ist. In diesem Beispiel wird auch davon ausgegangen, dass sich der virtuelle Computer in einem beendeten Zustand befindet.

Der zweite Befehl konvertiert die in $VirtDiskDrive gespeicherte virtuelle Festplatte in einen unterschiedlichen VHDX-Datenträger. Dieser Befehl löscht den Quelldatenträger.

Parameter

-BlockSizeBytes

Gibt die Blockgröße in Bytes für die virtuelle Festplatte an.

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

-DeleteSource

Gibt an, dass dieses Cmdlet die virtuelle Quell-Festplatte nach einer erfolgreichen Konvertierung löscht.

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

-Dynamic

Gibt an, dass die Größe einer virtuellen Festplatte dynamisch erweiterbar ist.

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

-FileName

Gibt den Dateinamen an, der verwendet werden soll, wenn Sie eine virtuelle Festplattendatei beim Hinzufügen zu einer virtuellen Maschine umbenennen.

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

-Fixed

Gibt an, dass eine virtuelle Festplatte in der Größe behoben ist. Gibt an, dass die Größe einer virtuellen Festplatte fest ist.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-Path

Gibt die logische Einheitsnummer (LUN) für ein virtuelles Laufwerkobjekt oder ein virtuelles Datenträgerlaufwerkobjekt auf einem SCSI-Bus an.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-ValidateOnCompletion

Gibt an, dass dieses Cmdlet die konvertierte virtuelle Festplatte nach einer erfolgreichen Konvertierung überprüft.

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

-VHDFormatType

Gibt den Festplattenformattyp an. Gültige Werte sind:

VHD
VMDK
VHDX

Type:	VHDFormatType
Accepted values:	VHD, VMDK, VHDX, VHDS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VHDX

Gibt an, dass ein virtueller Festplattentyp VHDX ist.

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

-VirtualDiskDrive

Gibt ein virtuelles Laufwerksobjekt an. Sie können entweder eine virtuelle Festplatte oder einen Pass-Through-Datenträger an ein virtuelles Laufwerkobjekt anfügen.

Type:	VirtualDiskDrive
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Ausgaben

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.