Freigeben über

Set-SCVirtualHardDisk

  • Referenz
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

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

Zu den Eigenschaften, die Sie ändern können, gehören:

  • Beschreibung
  • Ermöglichte
  • Name
  • Betriebssystem
  • Eigentümer
  • SharePath

Eine virtuelle Festplattendatei wird möglicherweise in der VMM-Bibliothek gespeichert oder an ein virtuelles Datenträgerlaufwerk auf einem virtuellen Computer oder einer Vorlage angefügt.

Um die Bus- und LUN-Einstellungen für ein virtuelles Laufwerk 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 mit dem Namen "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 gespeichert ist, in "Neueste Windows Server 2008 R2-Start-VHD".

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 mit dem Namen WindowsServer2008.vmdk ab und speichert dann das virtuelle Festplattenobjekt in der $VMDK Variablen.

Mit dem zweiten Befehl wird das virtuelle Festplattenobjekt deaktiviert, das in $VMDK gespeichert ist.

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.

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

-Enabled

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OperatingSystem

Gibt den Typ des Betriebssystems für einen virtuellen Computer an. Wenn Sie die Namen aller verfügbaren Betriebssysteme in VMM auflisten möchten, geben Sie Get-SCOperatingSystemein.

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

-Owner

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

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProductKey

Gibt einen Product Key an. Der Product Key ist eine 25-stellige Nummer, die die Produktlizenz identifiziert. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.

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

-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 wurde. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.

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

-SharePath

Gibt einen Pfad zu einer gültigen Bibliotheksfreigabe auf einem vorhandenen Bibliotheksserver an, der einen UNC-Pfad (Universal Naming Convention) verwendet.

Beispielformat: -SharePath "\\LibServer01\LibShare"

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

-Tag

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

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

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

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

Typ:VirtualHardDisk
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VirtualHardDisks

Gibt ein Array von virtuellen Festplattenobjekten an.

Typ:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VirtualizationPlatform

Gibt die Virtualisierungsplattform eines virtuellen Computerhosts an, der von VMM verwaltet wird. Die zulässigen Werte für diesen Parameter sind:

  • HyperV
  • VMwareESX
  • XENServer
Typ:VirtualizationPlatform
Zulässige Werte:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.