Copy-SCVirtualHardDisk

Kopiert eine virtuelle VMware-Festplattendatei (eine VMDK-Datei) in eine Windows-basierte virtuelle Festplattendatei (eine VHD-Datei) und konvertiert die virtuelle Festplatte für die Verwendung in einer VMM-Umgebung.

Syntax

Default (Standardwert)

Copy-SCVirtualHardDisk
    [-VMMServer <ServerConnection>]
    -VMDKPath <String>
    [-LibraryServer <LibraryServer>]
    [-SourceVMHost <Host>]
    -VMHost <Host>
    -Path <String>
    [-Owner <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Copy-SCVirtualHardDisk kopiert eine virtuelle VMware-Festplattendatei (eine .vmdk-Datei) in eine Windows-basierte virtuelle Festplattendatei (eine .vhd-Datei) und konvertiert die virtuelle Festplatte für die Verwendung in einer Virtual Machine Manager (VMM)-Umgebung. Der Inhalt des Datenträgers wird durch diesen Kopiervorgang beibehalten.

Virtuelle VMware-Festplatten, die in .vmdk-Dateien gespeichert sind, enthalten das Gastbetriebssystem, Anwendungen und Daten der virtuellen Maschine. Zu den von Copy-SCVirtualHardDisk unterstützten virtuellen VMware-Festplattenformaten gehören:

-- monolithischSparse

-- monolithischFlach

-- vmfs

-- twoGbMaxExtentSparse

-- twoGbMaxExtentFlat

Das Cmdlet Copy-SCVirtualHardDisk verwendet als Eingabe die .vmdk-Datei, auf die die .vmx-Datei verweist:

  • Die .vmx-Datei verweist auf eine .vmdk-Datei, die Metadaten enthält, die wiederum auf die binäre .vmdk-Datei verweisen.

  • Bei der .vmdk-Datei, die Sie mit dem Cmdlet Copy-VMDK angeben, handelt es sich um die .vmdk-Datei, die die Metadaten enthält (nicht die binäre .vmdk-Datei).

Beispiele

Beispiel 1: Konvertieren einer VMware-VMDK-Datei in der VMM-Bibliothek in eine Windows-basierte VHD-Datei auf einem Host

PS C:\> $LibServ = Get-SCLibraryServer -ComputerName "LibServer01.Contoso.com"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMMHost01.Contoso.com"
PS C:\> Copy-SCVirtualHardDisk -LibraryServer $LibServ -VMDKPath "\\LibServer01\MSSCVMMLibrary\VMware\VM01.vmdk" -VMHost $VMHost -Path "C:\StoredWindowsVMs"

Der erste Befehl ruft das Bibliothekserverobjekt mit dem Namen LibServer01 ab und speichert das Objekt in der Variablen $LibServ.

Der zweite Befehl ruft das Hostobjekt mit dem Namen VMHost01 ab und speichert das Objekt in der Variablen $VMHost. VMHost01 ist ein Hyper-V Host.

Mit dem letzten Befehl wird die .vmdk-Datei kopiert und konvertiert, die sich unter dem angegebenen Pfad (\LibServer01\MSSCVMMLibrary\VMware\VM01.vmdk) auf dem Bibliothekserver befindet, und die resultierende .vhd-Datei wird unter dem angegebenen Pfad (C:\StoredWindowsVMs) auf VMHost01 gespeichert. Beachten Sie, dass der Parameter Path bei Verwendung mit Copy-SCVirtualHardDisk keinen UNC-Pfad annehmen kann.

Hinweis: Copy-SCVirtualHardDisk verwendet als Eingabe die .vmdk-Datei, auf die die .vmx-Datei zeigt:

  • Die .vmx-Datei verweist auf eine .vmdk-Datei, die Metadaten enthält, die wiederum auf die binäre .vmdk-Datei verweisen.

  • Die .vmdk-Datei, die Sie mit Copy-SCVirtualHardDisk angeben, ist die .vmdk-Datei, die die Metadaten enthält (nicht die binäre .vmdk-Datei).

Parameter

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt 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

-LibraryServer

Gibt ein VMM-Bibliotheksserverobjekt an.

Parametereigenschaften

Typ:LibraryServer
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

-Owner

Gibt die besitzende Person eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"

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 den Zielpfad für den Vorgang an.

Beispielformate:

  • Lokaler Pfad: -Path "F:\"
  • UNC-Pfad: -Path "\\Library\Templates"
  • Pfad der Volume-GUID: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX-Pfad: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer-Pfad: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"

Parametereigenschaften

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

Parametersätze

(All)
Position:Named
Obligatorisch.:True
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

-SourceVMHost

Gibt das Hostobjekt der Quell-VM an.

Parametereigenschaften

Typ:Host
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

-VMDKPath

Gibt den Pfad zu einer virtuellen VMware-Festplattendatei (eine .vmdk-Datei) an, die in eine Windows-basierte virtuelle Festplattendatei (eine .vhd-Datei) konvertiert werden soll. Das VMDK steht für das Dateiformat Virtual Machine Disk (VMDK).

Beispielformat: -VMDKPath "\\FileServer01\MSSCVMMLibrary\VMDKS\VM01.vmdk"

Beispielformat: -VMDKPath "\[storage1\] /VM01/VM01.vmdk"

Parametereigenschaften

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

Parametersätze

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

-VMHost

Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .

Parametereigenschaften

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

Parametersätze

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

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

Parametersätze

(All)
Position:Named
Obligatorisch.:False
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

StandaloneVirtualHardDisk

Dieses Cmdlet gibt ein Array von StandaloneVirtualHardDisk-Objekten zurück.