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:

  • Beskrivning
  • Aktiverat
  • Namn
  • 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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 hindra användare från att använda objektet.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på ett VMM-objekt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OperatingSystem

Anger typ av operativsystem för en virtuell dator. Om du vill visa namnen på alla tillgängliga operativsystem i VMM skriver du Get-SCOperatingSystem.

Typ:OperatingSystem
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Owner

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

  • Exempelformat: -Owner "Contoso\PattiFuller"
  • Exempelformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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"

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 taggar, eller så kan du söka efter den fullständiga uppsättningen taggar.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserRole

Anger ett användarrollobjekt.

Typ:UserRole
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualHardDisk

Anger ett virtuellt hårddiskobjekt.

Typ:VirtualHardDisk
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualHardDisks

Anger en matris med virtuella hårddiskobjekt.

Typ:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualizationPlatform

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

  • HyperV
  • VMwareESX
  • XENServer
Typ:VirtualizationPlatform
Godkända värden:Unknown, VirtualServer, HyperV, VMwareVC, VMwareESX, XENServer
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMMServer

Anger ett VMM-serverobjekt.

Typ:ServerConnection
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.