Set-SCVirtualHardDiskConfiguration
Ändert die Konfigurationsinformationen der virtuellen Festplatte, die in einer virtuellen Computerkonfiguration 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 für virtuelle Festplatten, die in einer Konfiguration des virtuellen Computers enthalten sind.
Beispiele
Beispiel 1: Festlegen der Eigenschaften einer virtuellen Festplatte
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 $TrueDer erste Befehl ruft das Dienstkonfigurationsobjekt namens Service01 ab und speichert das Objekt in der $ServiceConfig Variablen.
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 in $TierConfig gespeicherte Computerebenenkonfiguration ab und speichert das Objekt in der $VMConfig Variablen.
Der vierte Befehl ruft die Konfiguration der virtuellen Festplatte für die erste konfiguration virtueller Computer 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 in $VHDConfig gespeicherten virtuellen Quellfestplatte, die in $VHD 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. Zulässige Werte für diesen Parameter:
- Keine
- UseFastest
- UseTarget
- UseNetwork
- UseSAN
- UseDifferencing
- UseExistingVirtualDisk
| Type: | DeploymentOption |
| Accepted values: | None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationLocation
Gibt den Zielpfad für oder auf einer virtuellen Festplatte an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileInjectionDestinationLocation
Gibt den Zielordnerpfad (relativer Pfad zum Stamm der Partition) an, in dem die Quelldatei(en) in die ausgewählte VHD eingefügt werden, bevor Sie den virtuellen Computer zum ersten Mal aktivieren.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileInjectionSourceLocation
Gibt den Speicherort (eine URL) der datei(n) an, die in den virtuellen Computer eingefügt werden soll, bevor er zum ersten Mal den virtuellen Computer aktiviert.
Wenn ein Ordner angegeben wird, werden alle Dateien unter diesem Ordner in den angegebenen Zielspeicherort eingefügt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileName
Gibt den Dateinamen an, der verwendet werden soll, wenn Sie eine virtuelle Festplattendatei beim Hinzufügen zu einer virtuellen Maschine umbenennen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentVirtualHardDiskDestinationPath
Gibt den Zielpfad für die übergeordnete virtuelle Festplatte an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentVirtualHardDiskPath
Gibt den Pfad zur übergeordneten virtuellen Festplatte an, die beim Erstellen eines anderen Datenträgers verwendet werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinDestinationLocation
Gibt an, ob der vom Benutzer ausgewählte Zielspeicherort während der Dienstbereitstellungskonfiguration beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinFileName
Gibt an, ob der vom Benutzer ausgewählte Dateiname während der Dienstbereitstellungskonfiguration beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinSourceLocation
Gibt an, ob der vom Benutzer ausgewählte Quellspeicherort während der Konfiguration der Dienstbereitstellung beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinStorageDisk
Gibt an, ob der vom Benutzer ausgewählte Speicherdatenträger während der Dienstbereitstellungskonfiguration beibehalten wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceDisk
Gibt die virtuelle Festplatte der Quelle an.
| Type: | StandaloneVirtualHardDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageClassification
Gibt ein Speicherklassifizierungsobjekt an.
| Type: | StorageClassification |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageDisk
Gibt einen Datenträger auf einem Hyper-V- oder VMware ESX-Host an, der 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 ist Raw Device Mapping (RDM). Bei einem Hostdatenträger kann es sich um eine logische Festplatte auf dem Host oder um ein logisches Gerät in einem SAN (Storage Area Network) handeln. Die virtuelle Maschine kann in VMM 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, aber keine Datenträgerkonvertierung. Citrix XenServer-Hosts unterstützen keine Pass-Through-Datenträger.
| Type: | StorageDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageQoSPolicy
Gibt ein StorageQoSPolicy-Objekt an.
| Type: | StorageQoSPolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VHDConfiguration
Gibt ein Virtuelles Festplattenkonfigurationsobjekt an.
| Type: | VirtualHardDiskConfiguration |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Ausgaben
VirtualHardDiskConfiguration
Dieses Cmdlet gibt ein VirtualHardDiskConfiguration -Objekt zurück.