Dela via

Set-SCVirtualHardDisk

  • Referens
Modul:
VirtualMachineManager

Ändrar egenskaperna för ett virtuellt hårddiskobjekt som används i 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

Cmdleten Set-SCVirtualHardDisk ändrar en eller flera egenskaper för ett virtuellt hårddiskobjekt som används i en VMM-miljö (Virtual Machine Manager). En virtuell hårddiskfil som används i VMM är antingen en Windows-baserad VHD-fil, en Citrix XenServer-baserad VHD-fil eller en VMware-baserad .vmdk-fil.

Egenskaper som du kan ändra är:

  • Description
  • Enabled
  • Name
  • Operativsystem
  • Ägare
  • Sharepath

En virtuell hårddiskfil kan lagras i VMM-biblioteket eller vara ansluten till en virtuell diskenhet på en virtuell dator eller mall.

Om du vill ändra inställningarna för Bus och LUN för en virtuell diskenhet använder du cmdleten Set-SCVirtualDiskDrive .

Exempel

Exempel 1: Ändra beskrivningen av en virtuell hårddisk

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"

Det första kommandot hämtar det virtuella hårddiskobjektet med namnet "WindowsServer2003BootVHD.vhd" från biblioteket på VMMServer01 och lagrar sedan objektet i variabeln $VHD.

Det andra kommandot ändrar beskrivningen av det virtuella hårddiskobjektet som lagras i $VHD till "Senaste Windows Server 2008 R2 Boot VHD".

Exempel 2: Aktivera en VMware-baserad virtuell hårddisk i biblioteket

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

Det första kommandot hämtar det virtuella hårddiskobjektet med namnet WindowsServer2008.vmdk och lagrar sedan det virtuella hårddiskobjektet i variabeln $VMDK.

Det andra kommandot inaktiverar det virtuella hårddiskobjektet som lagras i $VMDK.

Exempel 3: Ange en ägare för alla virtuella hårddiskar med en "okänd" ägare

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

Det här kommandot hämtar alla virtuella hårddiskobjekt från VMM-biblioteket vars ägare är "Okänd" och anger sedan en ägare för varje virtuellt hårddiskobjekt.

Parametrar

-Description

Anger en beskrivning av det virtuella hårddiskobjektet.

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

-Enabled

Aktiverar ett objekt när det är inställt på $True eller inaktiverar ett objekt när det är inställt på $False. Om du till exempel vill uppgradera programvara på en mall för virtuella datorer kan du inaktivera mallobjektet i VMM-biblioteket för att tillfälligt förhindra användare från att använda objektet.

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

-FamilyName

Anger ett familjenamn för en fysisk resurs i VMM-biblioteket. Det här värdet används tillsammans med Release, Namespace och Type för att upprätta likvärdighet mellan biblioteksresurser.

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

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.

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

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln som heter av den här parametern.

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

-Name

Anger namnet på ett VMM-objekt.

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

-OperatingSystem

Anger typ av operativsystem för en virtuell dator. Ange namnen på alla tillgängliga operativsystem i VMM genom att skriva Get-SCOperatingSystem.

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

-Owner

Anger ägaren av ett VMM-objekt i form av ett giltigt domänanvändarkonto.

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

-ProductKey

Anger en produktnyckel. Produktnyckeln är ett 25-siffrigt nummer som identifierar produktlicensen. En produktnyckel kan användas för att registrera VMM eller ett operativsystem som ska installeras på en virtuell dator eller värd.

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

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-Release

Anger en sträng som beskriver versionen av en biblioteksresurs. VMM skapar automatiskt ett versionsvärde för varje resurs som importeras till biblioteket. När resursen har importerats kan strängen anpassas.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SharePath

Anger en sökväg till en giltig biblioteksresurs på en befintlig biblioteksserver som använder en UNC-sökväg (Universal Naming Convention).

Exempelformat: -SharePath "\\LibServer01\LibShare"

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

-Tag

Anger ett ord eller en fras som ska associeras med ett objekt så att du kan söka efter alla objekt med den angivna uppsättningen taggar. Du kan söka efter en delmängd av taggar eller söka efter den fullständiga uppsättningen taggar.

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

-UserRole

Anger ett användarrollobjekt.

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

-VirtualHardDisk

Anger ett virtuellt hårddiskobjekt.

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

-VirtualHardDisks

Anger en matris med virtuella hårddiskobjekt.

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

Anger virtualiseringsplattformen för en virtuell datorvärd som hanteras av VMM. De acceptabla värdena för den här parametern är:

  • 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

Anger ett VMM-serverobjekt.

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

Utdata

VirtualHardDisk

Den här cmdleten returnerar ett VirtualHardDisk-objekt .

Kommentarer

  • Kräver ett virtuellt VMM-hårddiskobjekt som kan hämtas med hjälp av cmdleten Get-SCVirtualHardDisk .