Freigeben über

Set-SCVirtualHardDiskConfiguration

Modul:
VirtualMachineManager Module

Ändert die Konfigurationsinformationen für die virtuelle Festplatte, die in einer Konfiguration einer virtuellen Maschine enthalten sind.

Syntax

Default (Standardwert) 

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

Mit dem Cmdlet Set-SCVirtualHardDiskConfiguration werden die Konfigurationsinformationen für virtuelle Festplatten geändert, die in einer VM-Konfiguration 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 mit dem Namen Service01 ab und speichert das Objekt in der Variablen $ServiceConfig.

Mit dem zweiten Befehl wird die Konfiguration auf Computerebene für das in $ServiceConfig gespeicherte Dienstkonfigurationsobjekt abgerufen und das Objekt in der Variablen $TierConfig gespeichert.

Mit dem dritten Befehl wird die Konfiguration des virtuellen Computers für die in $TierConfig gespeicherte Konfiguration der Computerebene abgerufen und das Objekt in der Variablen $VMConfig gespeichert.

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

Mit dem fünften Befehl wird das virtuelle Festplattenobjekt mit dem Namen Win2k8R2BaseDisk.vhd aus der Bibliothek abgerufen und in der Variablen $VHD gespeichert.

Mit dem letzten Befehl wird die PinSourceLocation-Eigenschaft in der in $VHDConfig gespeicherten Konfiguration der virtuellen Festplatte für die in $VHD gespeicherte virtuelle Quellfestplatte aktualisiert, um den Wert der virtuellen Quellfestplatte anzuheften und so zu verhindern, dass er 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
  • VerwendenFastest
  • VerwendenZiel
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk

Parametereigenschaften

Typ:DeploymentOption
Standardwert:None
Zulässige Werte:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
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

-DestinationLocation

Gibt den Zielpfad für oder auf einer virtuellen Festplatte 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

-FileInjectionDestinationLocation

Gibt den Zielordnerpfad (relativer Pfad zum Stammverzeichnis der Partition) an, in den die Quelldatei(en) in die ausgewählte VHD eingefügt werden, bevor der virtuelle Computer zum ersten Mal eingeschaltet 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

-FileInjectionDestinationPartition

Gibt die Zielpartition der ausgewählten VHD an, in die die Quelldateien eingefügt werden, bevor der virtuelle Computer zum ersten Mal eingeschaltet wird.

Parametereigenschaften

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

-FileInjectionSourceLocation

Gibt den Speicherort (eine URL) der Datei(en) an, die vor dem ersten Einschalten der virtuellen Maschine in die virtuelle Maschine eingefügt werden sollen.

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

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

-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

-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

-ParentVirtualHardDiskDestinationPath

Gibt den Zielpfad für die übergeordnete virtuelle Festplatte 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

-ParentVirtualHardDiskPath

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

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

-PinDestinationLocation

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

Parametereigenschaften

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

-PinFileName

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

Parametereigenschaften

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

-PinSourceLocation

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

Parametereigenschaften

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

-PinStorageDisk

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

Parametereigenschaften

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

-SourceDisk

Gibt die virtuelle Quellfestplatte an.

Parametereigenschaften

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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

Parametereigenschaften

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

-StorageDisk

Gibt eine Festplatte auf einem Hyper-V- oder VMware ESX-Host an, die von einer virtuellen Maschine auf diesem Host anstelle einer virtuellen Festplatte verwendet werden kann. Dieser Datenträger wird als Pass-Through-Datenträger bezeichnet. Der entsprechende VMware-Begriff lautet Raw Device Mapping (RDM). Bei der Hostfestplatte handelt es sich entweder um eine lokale Festplatte oder eine logische Einheit in einem Storage Area Network (SAN). Mit VMM kann die virtuelle Maschine das Dateisystem des Hosts umgehen und direkt auf den Pass-Through-Datenträger zugreifen. Hyper-V Hosts unterstützen Pass-Through-Datenträger und die Konvertierung eines Pass-Through-Datenträgers in eine VHD. VMware ESX-Hosts unterstützen Pass-Through-Festplatten, aber keine Festplattenkonvertierung. Citrix XenServer-Hosts unterstützen keine Pass-Through-Datenträger.

Parametereigenschaften

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

-StorageQoSPolicy

Gibt ein StorageQoSPolicy-Objekt an.

Parametereigenschaften

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

-VHDConfiguration

Gibt ein Konfigurationsobjekt für eine virtuelle Festplatte an.

Parametereigenschaften

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

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

VirtualHardDiskConfiguration

Dieses Cmdlet gibt ein VirtualHardDiskConfiguration-Objekt zurück.