Delen via

Set-SCVirtualHardDisk

  • Referentie
Module:
VirtualMachineManager

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

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

Description

De cmdlet Set-SCVirtualHardDisk wijzigt een of meer eigenschappen van een virtueel hardeschijfobject dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager). Een virtuele harde schijfbestand 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 virtuele harde schijven 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 wordt de beschrijving van het virtuele hardeschijfobject dat is opgeslagen in $VHD gewijzigd 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 object virtuele harde schijf 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 de eigenaar Onbekend

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 harde schijf-object.

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

-Enabled

Hiermee schakelt u een object in wanneer deze is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een virtuele-machinesjabloon, 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-SCOperatingSystemu .

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers dat de productlicentie identificeert. 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 tags of u kunt zoeken naar de volledige set tags.

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

-UserRole

Hiermee geeft u een gebruikersrolobject.

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

-VirtualHardDisk

Hiermee geeft u een virtueel hardeschijfobject op.

Type:VirtualHardDisk
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualizationPlatform

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

  • 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

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

VirtualHardDisk

Deze cmdlet retourneert een VirtualHardDisk-object .

Notities

  • Hiervoor is een virtueel VMM-hardeschijfobject vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualHardDisk .