Delen via

Set-SCVirtualHardDisk

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een virtueel hardeschijfobject dat in VMM wordt gebruikt.

Syntaxis

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>]

Description

De Set-SCVirtualHardDisk cmdlet wijzigt een of meer eigenschappen van een virtuele hardeschijfobject dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager). Een virtueel hardeschijfbestand dat in VMM wordt gebruikt, is een VHD-bestand op basis van Windows, een .vhd-bestand op basis van Citrix XenServer of een VMware-bestand met .vmdk.

Eigenschappen die u kunt wijzigen, zijn onder andere:

  • Beschrijving
  • Ingeschakeld
  • Naam
  • Besturingssysteem
  • Eigenaar
  • SharePath

Een bestand met een virtuele harde schijf kan worden opgeslagen in de VMM-bibliotheek of kan worden gekoppeld aan een virtuele schijfstation op een virtuele machine of sjabloon.

Als u de bus- en LUN-instellingen voor een virtueel schijfstation wilt wijzigen, gebruikt u de cmdlet Set-SCVirtualDiskDrive.

Voorbeelden

Voorbeeld 1: De beschrijving van een virtuele harde schijf wijzigen

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"

Met de eerste opdracht wordt het virtuele hardeschijfobject met de naam WindowsServer2003BootVHD.vhd opgehaald uit de bibliotheek op VMMServer01 en wordt het object vervolgens opgeslagen in de variabele $VHD.

Met de tweede opdracht wijzigt u de beschrijving van het virtuele hardeschijfobject dat is opgeslagen in $VHD in 'Nieuwste Windows Server 2008 R2 Boot VHD'.

Voorbeeld 2: Een virtuele harde schijf op basis van VMware inschakelen in de bibliotheek

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

Met de eerste opdracht wordt het virtuele hardeschijfobject met de naam WindowsServer2008.vmdk opgehaald en wordt vervolgens het virtuele hardeschijfobject opgeslagen in de variabele $VMDK.

Met de tweede opdracht wordt het virtuele hardeschijfobject uitgeschakeld dat is opgeslagen in $VMDK.

Voorbeeld 3: Geef een eigenaar op voor alle virtuele harde schijven met een onbekende eigenaar

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

Met deze opdracht worden alle virtuele hardeschijfobjecten opgehaald uit de VMM-bibliotheek waarvan de eigenaar 'Onbekend' is en geeft u vervolgens een eigenaar op voor elk virtueel hardeschijfobject.

Parameters

-Description

Hiermee geeft u een beschrijving voor het virtuele hardeschijfobject.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Hiermee schakelt u een object in wanneer dit is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een sjabloon voor virtuele machines, kunt u het sjabloonobject in de VMM-bibliotheek uitschakelen om tijdelijk te voorkomen dat gebruikers dat object gebruiken.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FamilyName

Hiermee geeft u een familienaam op voor een fysieke resource in de VMM-bibliotheek. Deze waarde wordt gebruikt in combinatie met Release, Naamruimte en Type om gelijkwaardigheid tussen bibliotheekbronnen tot stand te brengen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OperatingSystem

Hiermee geeft u het type besturingssysteem voor een virtuele machine. Als u de namen van alle beschikbare besturingssystemen in VMM wilt weergeven, typt u Get-SCOperatingSystem.

Type:OperatingSystem
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers waarmee de productlicentie wordt geïdentificeerd. Een productcode kan worden gebruikt om VMM of een besturingssysteem te registreren dat moet worden geïnstalleerd op een virtuele machine of host.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Release

Hiermee geeft u een tekenreeks op die de release van een bibliotheekresource beschrijft. VMM maakt automatisch een releasewaarde voor elke resource die in de bibliotheek is geïmporteerd. Nadat de resource is geïmporteerd, kan de tekenreeks worden aangepast.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SharePath

Hiermee geeft u een pad naar een geldige bibliotheekshare op een bestaande bibliotheekserver die gebruikmaakt van een UNC-pad (Universal Naming Convention).

Voorbeeldindeling: -SharePath "\\LibServer01\LibShare"

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Hiermee geeft u een woord of woordgroep aan een object te koppelen, zodat u kunt zoeken naar alle objecten met de opgegeven set tags. U kunt zoeken naar een subset van tags of u kunt zoeken naar de volledige set tags.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserRole

Hiermee geeft u een gebruikersrolobject.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualHardDisk

Hiermee geeft u een virtuele harde schijf-object.

Type:VirtualHardDisk
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VirtualHardDisks

Hiermee geeft u een matrix van virtuele hardeschijfobjecten.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VirtualizationPlatform

Hiermee geeft u het virtualisatieplatform op van een virtuele-machinehost die wordt beheerd door VMM. De acceptabele waarden voor deze parameter zijn:

  • HyperV
  • VMwareESX
  • XENServer
Type:VirtualizationPlatform
Geaccepteerde waarden:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualHardDisk

Met deze cmdlet wordt een VirtualHardDisk--object geretourneerd.

Notities

  • Hiervoor is een VMM-object voor virtuele harde schijven vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualHardDisk.