Freigeben über

Set-SCVirtualHardDiskConfiguration

  • Referenz
Modul:
VirtualMachineManager

Ändert die Konfigurationsinformationen der virtuellen Festplatte, die in einer Konfiguration eines virtuellen Computers enthalten sind.

Syntax

Set-SCVirtualHardDiskConfiguration
   [-SourceDisk <StandaloneVirtualHardDisk>]
   [-PinSourceLocation <Boolean>]
   [-DestinationLocation <String>]
   [-PinDestinationLocation <Boolean>]
   [-FileName <String>]
   [-PinFileName <Boolean>]
   [-DeploymentOption <DeploymentOption>]
   [-StorageDisk <StorageDisk>]
   [-StorageClassification <StorageClassification>]
   [-StorageQoSPolicy <StorageQoSPolicy>]
   [-PinStorageDisk <Boolean>]
   [-ParentVirtualHardDiskPath <String>]
   [-ParentVirtualHardDiskDestinationPath <String>]
   [-FileInjectionSourceLocation <String>]
   [-FileInjectionDestinationLocation <String>]
   [-FileInjectionDestinationPartition <Int16>]
   -VHDConfiguration <VirtualHardDiskConfiguration>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCVirtualHardDiskConfiguration ändert die Konfigurationsinformationen der virtuellen Festplatte, die in einer Konfiguration eines virtuellen Computers enthalten sind.

Beispiele

Beispiel 1: Festlegen der Eigenschaften einer virtuellen Festplattenkonfiguration

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VHDConfig = Get-SCVirtualHardDiskConfiguration -VMConfiguration $VMConfig[0]
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Win2k8R2BaseDisk.vhd"
PS C:\> Set-SCVirtualHardDiskConfiguration -VHDConfiguration $VHDConfig -SourceDisk $VHD -PinSourceLocation $True

Der erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der variablen $ServiceConfig.

Der zweite Befehl ruft die Computerebenenkonfiguration für das in $ServiceConfig gespeicherte Dienstkonfigurationsobjekt ab und speichert das Objekt in der $TierConfig Variablen.

Der dritte Befehl ruft die Konfiguration des virtuellen Computers für die Computerebenenkonfiguration ab, die in $TierConfig gespeichert ist, und speichert das Objekt in der $VMConfig Variablen.

Der vierte Befehl ruft die Konfiguration der virtuellen Festplatte für die erste konfiguration des virtuellen Computers ab, die in $VMConfig gespeichert ist, und speichert das Objekt in der $VHDConfig Variablen.

Der fünfte Befehl ruft das virtuelle Festplattenobjekt mit dem Namen Win2k8R2BaseDisk.vhd aus der Bibliothek ab und speichert das Objekt in der $VHD Variablen.

Der letzte Befehl aktualisiert die PinSourceLocation-Eigenschaft in der virtuellen Festplattenkonfiguration, die in $VHDConfig für die in $VHD gespeicherte Quell-virtuelle Festplatte gespeichert ist, um den Wert der virtuellen Quellfestplatte anzuheften, wodurch verhindert wird, dass sie während der Platzierung geändert wird.

Parameter

-DeploymentOption

Gibt die Bereitstellungsoption für eine virtuelle Festplatte an. Die zulässigen Werte für diesen Parameter sind:

  • Nichts
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk
Typ:DeploymentOption
Zulässige Werte:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationLocation

Gibt den Zielpfad für oder auf einer virtuellen Festplatte an.

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

-FileInjectionDestinationLocation

Gibt den Zielordnerpfad (relativer Pfad zum Stamm der Partition) an, in den die Quelldatei(en) in die ausgewählte VHD eingefügt werden, bevor der virtuelle Computer zum ersten Mal aktiviert wird.

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

-FileInjectionDestinationPartition

Gibt die Zielpartition der ausgewählten VHD an, in die die Quelldateien eingefügt werden, bevor Sie den virtuellen Computer zum ersten Mal aktivieren.

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

-FileInjectionSourceLocation

Gibt den Speicherort (eine URL) der Datei(en) an, die in den virtuellen Computer eingefügt werden soll, bevor der virtuelle Computer zum ersten Mal aktiviert wird.

Wenn ein Ordner angegeben wird, werden alle Dateien unter diesem Ordner in den angegebenen Zielspeicherort eingefügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

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

-ParentVirtualHardDiskDestinationPath

Gibt den Zielpfad für die übergeordnete virtuelle Festplatte an.

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

-ParentVirtualHardDiskPath

Gibt den Pfad zur übergeordneten virtuellen Festplatte an, die beim Erstellen eines unterschiedlichen Datenträgers verwendet werden soll.

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

-PinDestinationLocation

Gibt an, ob der vom Benutzer ausgewählte Zielspeicherort während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-PinFileName

Gibt an, ob der vom Benutzer ausgewählte Dateiname während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-PinSourceLocation

Gibt an, ob der vom Benutzer ausgewählte Quellspeicherort während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-PinStorageDisk

Gibt an, ob der vom Benutzer ausgewählte Speicherdatenträger während der Dienstbereitstellungskonfiguration beibehalten wird.

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

-SourceDisk

Gibt die virtuelle Quellfestplatte an.

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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

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

-StorageDisk

Gibt einen Datenträger auf einem Hyper-V- oder VMware ESX-Host an, den ein virtueller Computer auf diesem Host anstelle einer virtuellen Festplatte verwenden kann. Dieser Datenträger wird als Pass-Through-Datenträger bezeichnet. Der entsprechende VMware-Begriff ist raw Device Mapping (RDM). Der Hostdatenträger ist entweder eine lokale Festplatte oder eine logische Einheit in einem Storage Area Network (SAN). Mit VMM kann der virtuelle Computer das Dateisystem des Hosts umgehen und direkt auf den Pass-Through-Datenträger zugreifen. Hyper-V Hosts unterstützen Pass-Through-Datenträger und Konvertierung eines Pass-Through-Datenträgers in eine VHD. VMware ESX-Hosts unterstützen Pass-Through-Datenträger, jedoch keine Datenträgerkonvertierung. Citrix XenServer-Hosts unterstützen keine Pass-Through-Datenträger.

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

-StorageQoSPolicy

Gibt ein StorageQoSPolicy -Objekt an.

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

-VHDConfiguration

Gibt ein Virtuelles Festplattenkonfigurationsobjekt an.

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

Ausgaben

VirtualHardDiskConfiguration

Dieses Cmdlet gibt ein VirtualHardDiskConfiguration-Objekt zurück.