Condividi tramite

Set-SCVirtualHardDisk

  • Riferimento
Modulo:
VirtualMachineManager

Modifica le proprietà di un oggetto disco rigido virtuale usato in VMM.

Sintassi

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

Descrizione

Il cmdlet Set-SCVirtualHardDisk modifica una o più proprietà di un oggetto disco rigido virtuale usato in un ambiente VMM (Virtual Machine Manager). Un file disco rigido virtuale usato in VMM è un file vhd basato su Windows, un file vhd basato su Citrix XenServer o un file vmdk basato su VMware.

Le proprietà modificabili sono le seguenti:

  • Descrizione
  • Attivato
  • Nome
  • Sistema operativo
  • Proprietario
  • SharePath

I file di disco rigido virtuale possono essere archiviati nella libreria VMM oppure collegati a un'unità disco virtuale su una macchina virtuale o in un modello.

Per modificare le impostazioni bus e LUN per un'unità disco virtuale, usare il cmdlet Set-SCVirtualDiskDrive .

Esempio

Esempio 1: Modificare la descrizione di un disco rigido virtuale

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"

Il primo comando recupera l'oggetto disco rigido virtuale denominato "WindowsServer2003BootVHD.vhd" dalla libreria in VMMServer01 e quindi archivia l'oggetto nella variabile $VHD.

Il secondo comando modifica la descrizione dell'oggetto disco rigido virtuale archiviato in $VHD in "VHD di avvio di Windows Server 2008 R2 più recente".

Esempio 2: Abilitare un disco rigido virtuale basato su VMware nella libreria

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

Il primo comando ottiene l'oggetto disco rigido virtuale denominato WindowsServer2008.vmdk e quindi archivia l'oggetto disco rigido virtuale nella variabile $VMDK.

Il secondo comando disabilita l'oggetto disco rigido virtuale archiviato in $VMDK.

Esempio 3: specificare un proprietario per tutti i dischi rigidi virtuali con un proprietario "Sconosciuto"

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

Questo comando ottiene tutti gli oggetti disco rigido virtuale dalla libreria VMM il cui proprietario è "Sconosciuto", quindi specifica un proprietario per ogni oggetto disco rigido virtuale.

Parametri

-Description

Specifica una descrizione per l'oggetto disco rigido virtuale.

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

-Enabled

Abilita un oggetto quando impostato su $True o disabilita un oggetto quando impostato su $False. Se ad esempio si desidera aggiornare il software in un modello di macchina virtuale, sarà possibile disabilitare l'oggetto modello nella libreria VMM per impedire temporaneamente agli utenti di utilizzare tale oggetto.

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

-FamilyName

Specifica un nome di famiglia per una risorsa fisica nella libreria VMM. Questo valore viene usato insieme a Release, Namespace e Type per stabilire l'equivalenza tra le risorse della libreria.

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

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-Name

Specifica il nome di un oggetto di VMM.

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

-OperatingSystem

Specifica il tipo di sistema operativo per una macchina virtuale. Per elencare i nomi di tutti i sistemi operativi disponibili in VMM, digitare Get-SCOperatingSystem.

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

-Owner

Specifica il proprietario di un oggetto VMM sotto forma di account utente di dominio valido.

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

-ProductKey

Specifica un codice Product Key. Il codice "Product Key" è un numero composto da 25 cifre che identifica la licenza del prodotto. Un codice Product Key può essere usato per registrare VMM o un sistema operativo da installare in una macchina virtuale o in un host.

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

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

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

-Release

Specifica una stringa che descrive la versione di una risorsa di libreria. VMM crea automaticamente un valore di versione per ogni risorsa importata nella libreria. Dopo l'importazione della risorsa, la stringa può essere personalizzata.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

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

-SharePath

Specifica il percorso di una condivisione di libreria valida su un server di libreria esistente che utilizza un percorso UNC (Universal Naming Convention).

Formato di esempio: -SharePath "\\LibServer01\LibShare"

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

-Tag

Specifica una parola o una frase da associare a un oggetto in modo che sia possibile cercare tutti gli oggetti con il set specificato di tag. È possibile cercare un subset di tag oppure cercare il set completo di tag.

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

-UserRole

Specifica un oggetto ruolo utente.

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

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

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

-VirtualHardDisks

Specifica una matrice di oggetti disco rigido virtuale.

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

Specifica la piattaforma di virtualizzazione di un host macchina virtuale gestito da VMM. I valori validi per questo parametro sono:

  • 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

Specifica un oggetto server Virtual Machine Manager.

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

Output

VirtualHardDisk

Questo cmdlet restituisce un oggetto VirtualHardDisk .

Note

  • Richiede un oggetto disco rigido virtuale VMM, che può essere recuperato usando il cmdlet Get-SCVirtualHardDisk .