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 di 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à che è possibile modificare includono:

  • Descrizione
  • Abilitato
  • Nome
  • Sistema operativo
  • Proprietario
  • SharePath

Un file del disco rigido virtuale potrebbe essere archiviato nella libreria VMM oppure potrebbe essere collegato a un'unità disco virtuale in una macchina virtuale o 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" e quindi specifica un proprietario per ogni oggetto disco rigido virtuale.

Parametri

-Description

Specifica una descrizione per l'oggetto disco rigido virtuale.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Enabled

Abilita un oggetto quando impostato su $True o disabilita un oggetto quando è impostato su $False. Ad esempio, se si vuole aggiornare il software in un modello di macchina virtuale, è possibile disabilitare l'oggetto modello nella libreria VMM per impedire temporaneamente agli utenti di usare tale oggetto.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome di un oggetto VMM.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:OperatingSystem
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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"
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProductKey

Specifica un codice Product Key. Il codice Product Key è un numero di 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Release

Specifica una stringa che descrive il rilascio di una risorsa di libreria. VMM crea automaticamente un valore di versione per ogni risorsa importata nella libreria. Dopo l'importazione della risorsa, è possibile personalizzare la stringa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SharePath

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

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:System.Collections.Generic.List`1[System.String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserRole

Specifica un oggetto ruolo utente.

Tipo:UserRole
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

Tipo:VirtualHardDisk
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VirtualHardDisks

Specifica una matrice di oggetti disco rigido virtuale.

Tipo:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VirtualizationPlatform

Specifica la piattaforma di virtualizzazione di un host di macchine virtuali gestito da VMM. I valori accettabili per questo parametro sono:

  • HyperV
  • VMwareESX
  • XENServer
Tipo:VirtualizationPlatform
Valori accettati:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.