Freigeben über


Convert-SCVirtualDiskDrive

Konvertiert eine virtuelle Festplatte von dynamisch in fest, von fest in dynamisch, von VHD in VHDX oder konvertiert einen Pass-Through-Datenträger in eine virtuelle Festplatte.

Syntax

Fixed

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

Dynamic

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

VHDX

Convert-SCVirtualDiskDrive
    [-VirtualDiskDrive] <VirtualDiskDrive>
    [-VHDX]
    [-DeleteSource]
    [-ValidateOnCompletion]
    [-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 Laufwerksobjekt angefügt ist, von dynamisch in fest oder von fest in dynamisch, von VHD in VHDX oder konvertiert einen Pass-Through-Datenträger, der an ein virtuelles Laufwerksobjekt angefügt ist, in eine virtuelle Festplatte.

Um die virtuelle Festplatte von einem Format in ein anderes zu konvertieren, muss sich die virtuelle Maschine, auf der die virtuelle Festplatte konfiguriert ist, in einem gestoppten Zustand befinden.

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

Eine VMware-basierte .vmdk-Datei auf einer virtuellen Maschine, die auf einem ESX-Host bereitgestellt wird, hat ein festes Format. Sie können nicht in ein dynamisches Format konvertiert werden.

Eine Citrix XenServer-basierte VHD-Datei auf einer virtuellen Maschine, die auf einem Citrix XenServer-Host bereitgestellt wird, hat ein festes Format. Sie können nicht in ein dynamisches Format konvertiert werden.

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

Ein Pass-Through-Datenträger ist eine physische Festplatte auf dem Host, die ein virtueller Computer anstelle einer virtuellen Festplatte verwenden kann. Mit diesem Cmdlet wird ein Pass-Through-Datenträger, der an ein virtuelles Laufwerk auf einem virtuellen Computer angefügt ist, in eine virtuelle Festplatte konvertiert. Die virtuelle Maschine muss sich auf einem Hyper-V Host befinden und sich im Status "Gestoppt" befinden.

Beispiele

Beispiel 1: Konvertieren eines Pass-Through-Datenträgers auf einem virtuellen Computer in einen virtuellen Datenträger

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

Mit dem ersten Befehl wird das VM-Objekt mit dem Namen VM01 mithilfe des Cmdlets Get-SCVirtualMachine abgerufen. Der Befehl speichert dieses Objekt in der Variablen $VM. In diesem Beispiel wird davon ausgegangen, dass VM01 derzeit für die Verwendung eines Passthrough-Datenträgers konfiguriert ist und dass der virtuelle Computer nur über einen Pass-Through-Datenträger verfügt.

Der zweite Befehl ruft das Objekt des virtuellen Laufwerks auf VM01 ab und speichert dieses Objekt dann in der Variablen $VirtDiskDrive.

Mit dem letzten Befehl wird das in $VirtDiskDrive gespeicherte Pass-Through-Laufwerk in eine feste virtuelle Festplatte umgewandelt. Der Befehl verschiebt die virtuelle Festplatte in den Zielordner C:\VirtualDiskDrives.

Beispiel 2: Konvertieren eines von mehreren Pass-Through-Datenträgern auf einem virtuellen Laufwerk 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 VM-Objekt mit dem Namen VM02 ab und speichert dieses Objekt dann in der Variablen $VM. In diesem Beispiel wird davon ausgegangen, dass VM02 über drei virtuelle Laufwerksobjekte verfügt und dass das erste virtuelle Laufwerk an ein virtuelles Festplattenlaufwerk gebunden ist, während sowohl das zweite als auch das dritte virtuelle Laufwerk an Pass-Through-Festplatten gebunden sind.

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

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

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

Mit dem ersten Befehl wird das Objekt des virtuellen Laufwerks abgerufen, das an den virtuellen Computer VM03 angefügt ist, und dann dieses Objekt des virtuellen Laufwerks in der Variablen $VirtDiskDrive gespeichert. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur über ein virtuelles Laufwerksobjekt verfügt und dass es sich bei der virtuellen Festplatte, die an das virtuelle Laufwerk angefügt ist, um eine dynamische virtuelle Festplatte handelt.

Der zweite Befehl wandelt die in $VirtDiskDrive gespeicherte virtuelle Festplatte in eine Festplatte um.

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

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

Mit dem ersten Befehl wird das Objekt des virtuellen Laufwerks abgerufen, das an den virtuellen Computer VM03 angefügt ist, und dieses Objekt in der Variablen $VirtDiskDrive gespeichert. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur über ein virtuelles Laufwerksobjekt verfügt und dass es sich bei der virtuellen Festplatte, die an das virtuelle Laufwerk angefügt ist, um eine dynamische virtuelle Festplatte handelt. 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 VHDX-Datenträger konvertiert.

Beispiel 5: Konvertieren einer differenzierenden VHD in eine differenzierende VHDX

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

Mit dem ersten Befehl wird das Objekt des virtuellen Laufwerks abgerufen, das an den virtuellen Computer VM04 angefügt ist, und dann wird dieses Objekt in der Variablen $VirtDiskDrive gespeichert. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur über ein virtuelles Laufwerksobjekt verfügt und dass es sich bei der virtuellen Festplatte, die an das virtuelle Laufwerk angefügt ist, um eine dynamische virtuelle Festplatte handelt. In diesem Beispiel wird auch davon ausgegangen, dass sich der virtuelle Computer in einem angehaltenen Zustand befindet.

Mit dem zweiten Befehl wird die differenzierende virtuelle Festplatte, die in $VirtDiskDrive gespeichert ist, in eine differenzierende VHDX-Festplatte konvertiert. Mit diesem Befehl wird die Quellfestplatte gelöscht.

Parameter

-BlockSizeBytes

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VHDX
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeleteSource

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VHDX
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Dynamic

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Dynamic
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FileName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Fixed

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fixed
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz ausgeführt werden, kurz bevor der letzte Befehl ausgeführt wird, der denselben Auftragsgruppenbezeichner enthält.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Gibt die LUN (Logical Unit Number) für ein virtuelles Laufwerksobjekt oder für ein virtuelles Laufwerksobjekt auf einem SCSI-Bus an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ValidateOnCompletion

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VHDX
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VHDFormatType

Gibt den Formattyp der Festplatte an. Gültige Werte sind:

  • VHD
  • VMDK
  • VHDX

Parametereigenschaften

Typ:VHDFormatType
Standardwert:None
Zulässige Werte:VHD, VMDK, VHDX, VHDS
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Fixed
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Dynamic
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VHDX

Gibt an, dass es sich bei einem virtuellen Festplattentyp um VHDX handelt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VHDX
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualDiskDrive

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

Parametereigenschaften

Typ:VirtualDiskDrive
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.