Set-SCVirtualMachine

Riferimento

Modulo:: VirtualMachineManager

Modifica le proprietà di una macchina virtuale gestita da VMM.

Sintassi

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SCVirtualMachine modifica le proprietà di una macchina virtuale gestita da Virtual Machine Manager (VMM).

Le proprietà che è possibile modificare includono quanto segue:

Associare una macchina virtuale a un cloud.
Nome, proprietario e descrizione di una macchina virtuale.
Ordine di avvio BIOS, se la macchina virtuale viene distribuita in un host Hyper-V.
Quantità di risorse nell'host usato da una macchina virtuale. Di seguito sono riportati i seguenti:
Quantità massima di risorse cpu host che una macchina virtuale può usare.
Previsto uso della CPU host da parte di una macchina virtuale.
Quantità di risorse cpu host usate da una macchina virtuale rispetto ad altre macchine virtuali nello stesso host.
Quantità di memoria host che può essere usata da una macchina virtuale.
Quantità di larghezza di banda nella rete dell'host che può essere usata da una macchina virtuale.
Impostazioni hardware per una macchina virtuale non correlate alle risorse host. Di seguito sono riportati i seguenti:
Numero di CPU.
Tipo di CPU.
Numero di operazioni di input/output del disco al secondo (IOPS).
Limitazione delle funzionalità della CPU per un sistema operativo precedente, ad esempio Windows NT 4.0.
Centro di costo, tag e impostazioni personalizzate usate per filtrare le macchine virtuali in base ai criteri.
Impostazioni che abilitano varie funzionalità facoltative, tra cui:
Abilitazione o disabilitazione di un oggetto libreria per renderlo disponibile o temporaneamente non disponibile agli utenti.
Abilitazione del backup di una macchina virtuale in un host Hyper-V con il servizio Copia Shadow del volume.
Abilitazione di una coppia chiave/valore per lo scambio di dati tra una macchina virtuale e il relativo host Hyper-V.
Abilitazione dell'arresto di una macchina virtuale dalla console di Hyper-V.
Abilitazione della sincronizzazione dell'ora tra una macchina virtuale e il relativo host Hyper-V.
Abilitazione del valore BIOS per NumLock per una macchina virtuale in un host Hyper-V.
Impostazione che identifica se una macchina virtuale è a disponibilità elevata, ovvero una macchina virtuale da distribuire in un nodo di un cluster host Hyper-V o in un cluster host Citrix XenServer.
Impostazione che determina se i servizi guest di virtualizzazione vengono installati in una macchina virtuale distribuita in un host Hyper-V.
Numero di secondi di ritardo prima di avviare una macchina virtuale.
Impostazione che identifica il sistema operativo usato per una macchina virtuale.
Avviare e arrestare le azioni per una macchina virtuale.
Impostazione che limita il numero di macchine virtuali che gli utenti self-service possono creare.
Impostazione usata per cambiare il ruolo usato da un utente self-service che appartiene a più ruoli per gestire una macchina virtuale.
Impostazione che assegna una macchina virtuale in un host ESX a un pool di risorse VMware.

Se si desidera modificare le proprietà di un'unità floppy virtuale, unità DVD virtuale, scheda di rete virtuale o scheda SCSI virtuale associata a una macchina virtuale specifica, usare il Set-SCVirtualFloppyDrive, Set-SCVirtualDRIVE, Set-SCVirtualNetworkAdaptero cmdlet Set-SCVirtualScsiAdapter.

Esempio

Esempio 1: Specificare una quantità di memoria per una macchina virtuale esistente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e quindi archivia tale oggetto nella variabile $VM.

Il secondo determina se la macchina virtuale archiviata in $VM è in uno stato spento. Se la macchina virtuale non è spenta, il comando usa il comando Stop-SCVirtualMachine per spegnere la macchina virtuale. Per altre informazioni sull'accensione di una macchina virtuale, digitare Get-Help Stop-SCVirtualMachine.

L'ultimo comando modifica la memoria allocata a VM01 a 1024 MB.

Esempio 2: Modificare il ruolo utente usato per gestire una macchina virtuale per un utente che appartiene a più ruoli utente self-service

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

Il primo comando ottiene l'oggetto macchina virtuale denominato VM02 da VMMServer01 e quindi archivia tale oggetto nella variabile $VM.

Il secondo comando ottiene l'oggetto ruolo utente denominato ContosoSelfServiceUsers e quindi archivia l'oggetto nella variabile $SSRole.

L'ultimo comando specifica che ai membri del ruolo utente self-service denominato SSUserRole3 viene ora concessa l'autorizzazione per gestire la macchina virtuale denominata VM02.

Nota: VMM usa il parametro UserRole per impostare le macchine virtuali gestite dai membri di un ruolo utente self-service specifico. In genere, non è necessario usare il cmdlet Set-SCVirtualMachine con il parametro UserRole per configurare questa impostazione. Tuttavia, se uno o più utenti sono membri di più ruoli utente self-service e si concede loro l'autorizzazione per gestire più macchine virtuali nello stesso host, potrebbe verificarsi un caso in cui si vuole cambiare il ruolo utente autorizzato a gestire una determinata macchina virtuale. In questo esempio viene illustrato lo scenario.

Esempio 3: Disabilitare la sincronizzazione dell'ora in una macchina virtuale usata come controller di dominio

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

Il primo comando archivia l'impostazione corrente per $ErrorActionPreference nella variabile $EAP. Questa variabile viene usata in un secondo momento per restituire l'impostazione al valore originale.

Il secondo comando imposta la preferenza dell'azione su STOP. Questa preferenza di azione di errore modifica un errore da un errore non irreversibile a un errore irreversibile. L'oggetto errore viene generato come eccezione anziché essere scritto nella pipe di output e il comando non continua a essere eseguito.

Il terzo comando ottiene l'oggetto macchina virtuale denominato VM03 e archivia tale oggetto nella variabile $VM.

Il quarto comando disabilita l'impostazione di sincronizzazione dell'ora. In genere, la disabilitazione della sincronizzazione dell'ora è necessaria per le macchine virtuali che fungono da controller di dominio. Il comando usa l'istruzione trap per intercettare le eccezioni di terminazione. Se il comando Set-SCVirtualMachine ha esito negativo, viene visualizzata la stringa nell'istruzione trap . La continuazione viene usata nell'istruzione trap per continuare l'esecuzione anziché uscire. Il cmdlet Out-Null reindirizza l'output a $Null anziché inviarlo alla console.

L'ultimo comando imposta il valore per $ErrorActionPreference sul valore archiviato in $EAP.

Esempio 4: Impostare l'ordine di avvio del dispositivo per tutte le macchine virtuali che supportano questa funzionalità

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

Il primo comando archivia l'impostazione corrente per $ErrorActionPreference in $EAP. Questa variabile viene usata in un secondo momento per restituire l'impostazione al valore originale.

Il secondo comando imposta la preferenza dell'azione di errore su Arresta. Questa preferenza di azione di errore modifica un errore da un errore non irreversibile a un errore irreversibile. L'oggetto errore viene generato come eccezione anziché essere scritto nella pipe di output e il comando non continua a essere eseguito.

Il terzo comando ottiene ogni oggetto macchina virtuale archivia gli oggetti in $VMs. L'uso del simbolo @ e delle parentesi garantisce che il comando archivii i risultati in una matrice nel caso in cui il comando restituisca un singolo oggetto o un valore Null.

Il quarto comando imposta l'ordine di avvio BIOS per ogni macchina virtuale su PXEBoot,IDEHarddrive,CD,Floppy. Il comando usa un'istruzione trap per rilevare le eccezioni irreversibili. Se l'comando Set-SCVirtualMachine ha esito negativo, viene visualizzata la stringa nell'istruzione trap. L'istruzione continue viene usata nell'istruzione trap per continuare l'esecuzione anziché uscire dal ciclo di ForEach . Il cmdlet Out-Null reindirizza l'output a $Null anziché inviarlo alla console.

Nota: il parametro bootOrder viene usato solo per le macchine virtuali negli host Hyper-V e Citrix XenServer. Non viene usato per le macchine virtuali in host VMware ESX. Gli host XenServer non supportano i dischi floppy e quindi ignora floppy se elencati nell'ordine di avvio.

L'ultimo comando imposta il valore per $ErrorActionPreference sul valore archiviato in EAP.

Per altre informazioni sull'istruzione del ciclo ForEach standard di Windows PowerShell, digitare .

Esempio 5: Specificare un proprietario per tutte le macchine virtuali senza proprietario

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

Questo comando ottiene tutti gli oggetti macchina virtuale in VMMServer01, seleziona solo gli oggetti macchina virtuale in cui non è elencato alcun proprietario e specifica un proprietario per ogni macchina virtuale.

Esempio 6: Abilitare la memoria dinamica per una macchina virtuale esistente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

Il primo comando ottiene l'oggetto macchina virtuale VM06 e archivia l'oggetto nella variabile $VM. Per abilitare la memoria dinamica in una macchina virtuale, la macchina virtuale deve risiedere in un host che esegue Windows Server 2008 R2 SP1 o versione successiva.

Il secondo comando determina se la macchina virtuale archiviata in $VM è in stato spento. Se la macchina virtuale non è spenta, il comando usa il comando Stop-SCVirtualMachine per spegnere la macchina virtuale.

L'ultimo comando abilita la memoria dinamica, imposta la memoria di avvio su 1024 MB e imposta la memoria massima su 2048 MB. La memoria di avvio è la quantità di memoria nell'host allocata a VM06 all'avvio. La memoria massima è la quantità massima di memoria nell'host allocata a VM06.

Parametri

-AutomaticCriticalErrorAction

Specifica l'azione da eseguire quando la macchina virtuale rileva un errore critico e supera la durata del timeout specificata dal parametro AutomaticCriticalErrorActionTime out. I valori accettabili per questo parametro sono: Pause e None.

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

-AutomaticCriticalErrorActionTimeout

Specifica la quantità di tempo, espressa in minuti, di attesa in pausa critica prima di spegnere la macchina virtuale.

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

-AvailabilitySetNames

Specifica un elenco di nomi dei set di disponibilità.

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

-BlockDynamicOptimization

Indica se l'ottimizzazione dinamica è bloccata per una macchina virtuale.

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

-BootOrder

Specifica l'ordine, come matrice, di dispositivi usati da una macchina virtuale in un host Hyper-V per l'avvio. I valori validi sono:

CD
IDEHardDrive
PXEBoot
Floscio

Tipo:	BootDevice[]
Valori accettati:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CapabilityProfile

Specifica un oggetto profilo di funzionalità.

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

-CheckpointType

Specifica il tipo di checkpoint. I valori accettabili per questo parametro sono:

Disabile
Produzione
ProductionOnly
Standard

Tipo:	CheckpointType
Valori accettati:	Disabled, Production, ProductionOnly, Standard
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ClearDRProtection

Indica che questo cmdlet reimposta l'opzione di protezione del ripristino dei dati.

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

-Cloud

Specifica un oggetto cloud privato.

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

-ClusterNonPossibleOwner

Specifica un elenco di nomi dei proprietari di nodi del cluster non possibili per una macchina virtuale specificata.

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

-ClusterPreferredOwner

Specifica un elenco di nomi dei proprietari dei nodi del cluster preferiti per una determinata macchina virtuale.

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

-CostCenter

Specifica il centro di costo per una macchina virtuale. È possibile raccogliere dati sull'allocazione di macchine virtuali o risorse allocate alle macchine virtuali per il sistema di fatturazione.

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

-CPUCount

Specifica il numero di CPU nella macchina virtuale. Gli host seguenti supportano il numero di processori seguente:

Hyper-V. Fino a quattro CPU per macchina virtuale, a seconda del sistema operativo guest.
VMware ESX. Fino a quattro CPU per macchina virtuale per qualsiasi sistema operativo guest supportato, ad eccezione di una CPU in una macchina virtuale che esegue Windows NT 4.0.
Citrix XenServer. Fino a otto CPU per macchina virtuale, a seconda del sistema operativo guest.

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

-CPUExpectedUtilizationPercent

Specifica la percentuale di CPU nell'host che si prevede che questa macchina virtuale venga usata. Questo valore viene usato solo quando VMM determina un host appropriato per la macchina virtuale.

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

-CPULimitForMigration

Indica se limitare le funzionalità del processore per la macchina virtuale specificata per consentire la migrazione a un computer fisico con una versione diversa dello stesso processore del computer di origine. VMM non supporta la migrazione di macchine virtuali tra computer fisici con processori di produttori diversi.

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

-CPULimitFunctionality

Indica se fornire funzionalità di CPU limitate per la macchina virtuale. Specificare un valore di $True per supportare un sistema operativo precedente, ad esempio Windows NT 4.0, in una macchina virtuale distribuita in un host Hyper-V o in un host VMware ESX.

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

-CPUMaximumPercent

Specifica la percentuale più elevata delle risorse totali di una singola CPU nell'host che una macchina virtuale può usare contemporaneamente.

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

-CPUPerVirtualNumaNodeMaximum

Specifica il numero massimo di CPU consentite per ogni nodo NUMA virtuale.

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

-CPURelativeWeight

Specifica la quantità di risorse della CPU in un host che questa macchina virtuale può usare rispetto ad altre macchine virtuali nello stesso host. Una macchina virtuale con un valore di peso maggiore viene allocata più risorse della CPU rispetto a una macchina virtuale con un valore di peso inferiore. Il termine VMware per questi valori è condivisioni. I tipi di host supportano i valori relativi seguenti:

Hyper-V. da 1 a 10000.
VMware ESX. Alto. 2000.
VMware ESX. Al di sopra del normale. 1500.
VMware ESX. Normale (impostazione predefinita). 1000.
VMware ESX. Al di sotto del normale. 750.
VMware ESX. Basso. 500.
VMware ESX. Personalizzato da 1 a 1000000.
Citrix XenServer. Da 1 a 65536, in genere è 256.

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

-CPUReserve

Specifica la percentuale minima delle risorse di una singola CPU nell'host da allocare alla macchina virtuale. La percentuale di capacità della CPU disponibile per la macchina virtuale non è mai inferiore a questa percentuale.

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

-CPUType

Specifica il tipo di CPU per una macchina virtuale. Per ottenere tutti i tipi di CPU disponibili per l'uso nelle macchine virtuali in un ambiente VMM, vedere il cmdlet Get-SCCPUType .

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