Condividi tramite


Set-SCVirtualHardDisk

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

Sintassi

Default

Set-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-OperatingSystem <OperatingSystem>]
    [-VirtualizationPlatform <VirtualizationPlatform>]
    [-Tag <System.Collections.Generic.List`1[System.String]>]
    [-ProductKey <String>]
    [-UserRole <UserRole>]
    [-Enabled <Boolean>]
    [-VMMServer <ServerConnection>]
    [-JobGroup <Guid>]
    [-Name <String>]
    [-SharePath <String>]
    [-Description <String>]
    [-Owner <String>]
    [-FamilyName <String>]
    [-Release <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

EquivalencySet

Set-SCVirtualHardDisk
    [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Descrizione

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

Le proprietà che è possibile modificare includono:

  • Descrizione
  • Attivato
  • Nome
  • Sistema operativo
  • Proprietario
  • Percorso condiviso

Un file del disco rigido virtuale può essere archiviato nella libreria VMM oppure può essere collegato a un'unità disco virtuale in una macchina virtuale o in un modello.

Per modificare le impostazioni del bus e del LUN per un'unità disco virtuale, utilizzare 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 "Latest Windows Server 2008 R2 Boot VHD".

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Enabled

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

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FamilyName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-JobVariable

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome di un oggetto VMM.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:OperatingSystem
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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"

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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, la stringa può essere personalizzata.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RunAsynchronously

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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"

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 di tag specificato. È possibile cercare un sottoinsieme di tag oppure l'intero set di tag.

Proprietà dei parametri

Tipo:

System.Collections.Generic.List`1[System.String]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserRole

Specifica un oggetto ruolo utente.

Proprietà dei parametri

Tipo:UserRole
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

Proprietà dei parametri

Tipo:VirtualHardDisk
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VirtualHardDisks

Specifica una matrice di oggetti disco rigido virtuale.

Proprietà dei parametri

Tipo:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EquivalencySet
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VirtualizationPlatform

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

  • HyperV
  • VMwareESX
  • XENServer

Proprietà dei parametri

Tipo:VirtualizationPlatform
Valore predefinito:None
Valori accettati:Unknown, VirtualServer, HyperV, VMwareVC, VMwareESX, XENServer
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VMMServer

Specifica un oggetto server VMM.

Proprietà dei parametri

Tipo:ServerConnection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

VirtualHardDisk

Questo cmdlet restituisce un oggetto VirtualHardDisk .

Note

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