Freigeben über

Convert-SCVirtualDiskDrive

  • Referenz
Modul:
VirtualMachineManager

Konvertiert eine virtuelle Festplatte von dynamischer in feste, von fester in dynamische Festplatte, von VHD in VHDX 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 cmdlet konvertiert eine vorhandene virtuelle Festplatte, die an ein virtuelles Laufwerkobjekt angefügt ist, von dynamischer in feste oder dynamischer, von VHD in VHDX oder konvertiert einen Pass-Through-Datenträger, der an ein virtuelles Festplattenobjekt 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 angehaltenen Zustand sein.

Sie können nur das Datenträgerformat einer Windows-basierten VHD-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, ist 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, ist im Format behoben. Sie können es nicht in ein dynamisches Format konvertieren.

Sie können nur das Datenträgerformat einer Windows-basierten virtuellen Festplatte von VHD in VHDX 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 angehaltenen Zustand sein.

Ein Pass-Through-Datenträger ist eine physische Festplatte auf dem Host, die ein virtueller Computer anstelle einer virtuellen Festplatte verwenden kann. Dieses Cmdlet konvertiert einen Pass-Through-Datenträger, der an ein virtuelles Laufwerk auf einem virtuellen Computer angefügt ist, in eine virtuelle Festplatte. Der virtuelle Computer muss sich auf einem Hyper-V-Host befinden und sich in einem angehaltenen Zustand befinden.

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 objekt des virtuellen Computers mit dem Namen 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 über einen Pass-Through-Datenträger verfügt.

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

Der letzte Befehl konvertiert das Pass-Through-Laufwerk, das in $VirtDiskDrive gespeichert ist, in eine feste virtuelle Festplatte. Der Befehl verschiebt die virtuelle Festplatte in den Zielordner C:\VirtualDiskDrives.

Beispiel 2: Konvertieren eines 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 objekt des virtuellen Computers mit dem Namen VM02 ab und speichert dieses Objekt dann in der $VM Variablen. In diesem Beispiel wird davon ausgegangen, dass VM02 über drei Virtuelle Datenträgerlaufwerkobjekte verfügt und dass das erste virtuelle Festplattenlaufwerk an eine virtuelle Festplatte gebunden ist, während sowohl die zweiten als auch die dritten virtuellen Festplattenlaufwerke an Pass-Through-Datenträger gebunden sind.

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

Der letzte Befehl konvertiert den dritten Pass-Through-Datenträger, der das dritte Mitglied des $VirtDiskDrive Arrays ist, in eine dynamisch erweiterte virtuelle Festplatte. Mit dem Befehl wird diese neue virtuelle Festplatte in den Zielordner D:verschoben.

Beispiel 3: Konvertieren einer dynamischen VHD, die an ein virtuelles Laufwerkobjekt auf einem virtuellen Computer angefügt ist, 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 Laufwerkobjekt ab, das an den virtuellen Computer VM03 angefügt ist, und speichert dann dieses virtuelle Laufwerkobjekt in der $VirtDiskDrive Variablen. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur ein Objekt für ein virtuelles Laufwerk aufweist und dass die virtuelle Festplatte, die mit dem virtuellen Festplattenlaufwerk verbunden ist, eine dynamische virtuelle Festplatte ist.

Der zweite Befehl konvertiert die virtuelle Festplatte, die in $VirtDiskDrive gespeichert ist, 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 Laufwerkobjekt ab, das an virtuelle 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 Objekt für ein virtuelles Laufwerk aufweist und dass die virtuelle Festplatte, die mit dem virtuellen Festplattenlaufwerk verbunden ist, eine dynamische virtuelle Festplatte ist. In diesem Beispiel wird auch davon ausgegangen, dass sich der virtuelle Computer in einem angehaltenen Zustand befindet.

Der zweite Befehl konvertiert die virtuelle Festplatte, die in $VirtDiskDrive gespeichert ist, 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 Laufwerkobjekt ab, das an vm04 des virtuellen Computers angefügt ist, und speichert dieses Objekt dann in der variablen $VirtDiskDrive. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur ein Objekt für ein virtuelles Laufwerk aufweist und dass die virtuelle Festplatte, die mit dem virtuellen Festplattenlaufwerk verbunden ist, eine dynamische virtuelle Festplatte ist. In diesem Beispiel wird auch davon ausgegangen, dass sich der virtuelle Computer in einem angehaltenen Zustand befindet.

Mit dem zweiten Befehl wird die in $VirtDiskDrive gespeicherte virtuelle Festplatte in einen unterschiedlichen VHDX-Datenträger konvertiert. Mit diesem Befehl wird der Quelldatenträger gelöscht.

Parameter

-BlockSizeBytes

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

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

-DeleteSource

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

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

-Dynamic

Gibt an, dass eine virtuelle Festplatte dynamisch erweitert werden kann.

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

-FileName

Gibt den Dateinamen an, der verwendet werden soll, wenn Sie eine virtuelle Festplatte umbenennen, während Sie sie einem virtuellen Computer hinzufügen.

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

-Fixed

Gibt an, dass eine virtuelle Festplatte in der Größe festgelegt ist. Gibt an, dass eine virtuelle Festplatte in der Größe festgelegt ist.

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

-JobGroup

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

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

-JobVariable

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

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

-Path

Gibt die logische Einheitennummer (LUN) für ein Virtuelles Laufwerkobjekt oder ein virtuelles Laufwerkobjekt auf einem SCSI-Bus an.

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

-PROTipID

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

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-ValidateOnCompletion

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

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

-VHDFormatType

Gibt den Festplattenformattyp an. Gültige Werte sind:

  • VHD
  • VMDK
  • VHDX
Typ:VHDFormatType
Zulässige Werte:VHD, VMDK, VHDX, VHDS
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VHDX

Gibt an, dass ein virtueller Festplattentyp VHDX ist.

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

-VirtualDiskDrive

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

Typ:VirtualDiskDrive
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive--Objekt zurück.