Set-SCVirtualHardDisk

Modul:

VirtualMachineManager

Ändert die Eigenschaften eines virtuellen Festplattenobjekts, das in VMM verwendet wird.

Syntax

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCVirtualHardDisk ändert eine oder mehrere Eigenschaften eines virtuellen Festplattenobjekts, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Eine virtuelle Festplattendatei, die in VMM verwendet wird, ist entweder eine windowsbasierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-basierte VMDK-Datei.

Sie können u. a. folgende Eigenschaften ändern:

• BESCHREIBUNG
• Aktiviert
• Name
• Betriebssystem
• Besitzer
• SharePath

Eine virtuelle Festplattendatei kann in der VMM-Bibliothek gespeichert oder mit einem virtuellen Laufwerk auf einer virtuellen Maschine oder in einer Vorlage verbunden sein.

Um die Bus- und LUN-Einstellungen für ein virtuelles Datenträgerlaufwerk zu ändern, verwenden Sie das Cmdlet Set-SCVirtualDiskDrive .

Beispiele

Beispiel 1: Ändern der Beschreibung einer virtuellen Festplatte

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

Der erste Befehl ruft das virtuelle Festplattenobjekt namens "WindowsServer2003BootVHD.vhd" aus der Bibliothek auf VMMServer01 ab und speichert das Objekt dann in der $VHD Variablen.

Der zweite Befehl ändert die Beschreibung des virtuellen Festplattenobjekts, das in $VHD in "Neueste Windows Server 2008 R2 Boot VHD" gespeichert ist.

Beispiel 2: Aktivieren einer VMware-basierten virtuellen Festplatte in der Bibliothek

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

Der erste Befehl ruft das virtuelle Festplattenobjekt namens WindowsServer2008.vmdk ab und speichert dann das virtuelle Festplattenobjekt in der $VMDK Variablen.

Der zweite Befehl deaktiviert das in $VMDK gespeicherte virtuelle Festplattenobjekt.

Beispiel 3: Angeben eines Besitzers für alle virtuellen Festplatten mit einem "Unbekannten" Besitzer

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

Dieser Befehl ruft alle virtuellen Festplattenobjekte aus der VMM-Bibliothek ab, deren Besitzer "Unbekannt" ist, und gibt dann einen Besitzer für jedes virtuelle Festplattenobjekt an.

Parameter

-Description

Gibt eine Beschreibung für das virtuelle Festplattenobjekt an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Aktiviert ein Objekt, wenn er auf $True festgelegt ist, oder deaktiviert ein Objekt, wenn er auf $False festgelegt ist. Wenn Sie beispielsweise Software in einer Vorlage für virtuelle Maschinen aktualisieren möchten, können Sie das Vorlagenobjekt in der VMM-Bibliothek deaktivieren, um vorübergehend zu verhindern, dass Benutzer das Objekt verwenden.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FamilyName

Gibt einen Familiennamen für eine physische Ressource in der VMM-Bibliothek an. Dieser Wert wird in Verbindung mit Release, Namespace und Type verwendet, um die Äquivalenz zwischen Bibliotheksressourcen herzustellen.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

Type:	Guid
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

-Name

Gibt den Namen eines VMM-Objekts an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystem

Gibt den Betriebssystemtyp für eine virtuelle Maschine an. Geben Sie die Get-SCOperatingSystemNamen aller verfügbaren Betriebssysteme in VMM auf.

Type:	OperatingSystem
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProductKey

Gibt einen Product Key an. Beim Product Key handelt es sich um eine 25-stellige Zahl zur Identifizierung der Produktlizenz. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.

Type:	String
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

-Release

Gibt eine Zeichenfolge an, die die Veröffentlichung einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Freigabewert für jede Ressource, die in die Bibliothek importiert wird. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-SharePath

Gibt einen Pfad zu einer Bibliotheksfreigabe auf einem vorhandenen Bibliothekserver an, für den ein UNC-Pfad (Universal Naming Convention) verwendet wird.

Beispielformat: -SharePath "\\LibServer01\LibShare"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Gibt ein Wort oder einen Ausdruck an, der einem Objekt zugeordnet werden soll, damit Sie nach allen Objekten mit dem angegebenen Satz von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach der vollständigen Gruppe von Tags suchen.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

Gibt ein Benutzerrollenobjekt an.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

Type:	VirtualHardDisk
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualHardDisks

Gibt ein Array von virtuellen Festplattenobjekten an.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualizationPlatform

Gibt die Virtualisierungsplattform eines von VMM verwalteten Hosts für virtuelle Maschinen an. Zulässige Werte für diesen Parameter:

• HyperV
• VMwareESX
• Xenserver

Type:	VirtualizationPlatform
Accepted values:	Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Ausgaben

VirtualHardDisk

Dieses Cmdlet gibt ein VirtualHardDisk-Objekt zurück.

Hinweise

• Erfordert ein virtuelles VMM-Festplattenobjekt, das mithilfe des Cmdlets Get-SCVirtualHardDisk abgerufen werden kann.

Ähnliche Themen

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualHardDisk
• Move-SCVirtualHardDisk
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive