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. tra cui:
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. tra cui:
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 per gli 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 l'host Hyper-V.
Abilitazione dell'arresto di una macchina virtuale dalla console Hyper-V.
Abilitazione della sincronizzazione dell'ora tra una macchina virtuale e l'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 dell'avvio di una macchina virtuale.
Impostazione che identifica il sistema operativo utilizzato 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 appartenente 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, un'unità DVD virtuale, una scheda di rete virtuale o una scheda SCSI virtuale associata a una macchina virtuale specifica, usare il cmdlet Set-SCVirtualFloppyDrive, Set-SCVirtualDRIVE, Set-SCVirtualNetworkAdapter o 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 l'oggetto nella variabile $VM.

Il secondo determina se la macchina virtuale archiviata in $VM è in uno stato spento. Se la macchina virtuale non è in stato spento, 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 in 1024 MB la quantità di memoria allocata per VM01.

Esempio 2: Modificare il ruolo utente usato per gestire una macchina virtuale per un utente appartenente 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, è possibile che si verifichi un caso in cui si vuole cambiare il ruolo utente autorizzato a gestire una determinata macchina virtuale. Nell'esempio viene illustrato tale 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 nella variabile $EAP l'impostazione corrente per $ErrorActionPreference. Questa variabile viene usata in un secondo momento per restituire l'impostazione al valore originale.

Il secondo comando imposta su STOP la preferenza relativa all'azione. Tale preferenza relativa all'azione da eseguire in caso di errore consente di trasformare in errore fatale un errore non fatale. 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 l'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 irreversibili. Se il comando Set-SCVirtualMachine ha esito negativo, viene visualizzata la stringa nell'istruzione trap . La continuazione viene utilizzata nell'istruzione trap per continuare l'esecuzione anziché uscire. Il cmdlet Out-Null reindirizza l'output alla variabile $Null anziché inviarlo alla console.

L'ultimo comando imposta $ErrorActionPreference sul valore archiviato nella variabile $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 secondo comando imposta la preferenza per l'azione di errore su Arresta. Tale preferenza relativa all'azione da eseguire in caso di errore consente di trasformare in errore fatale un errore non fatale. 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 DEL BIOS per ogni macchina virtuale su PXEBoot,IDEHarddrive,CD,Floppy. Il comando usa un'istruzione trap per intercettare le eccezioni di terminazione. Se il comando Set-SCVirtualMachine ha esito negativo, viene visualizzata la stringa nell'istruzione trap. Continue viene usato nell'istruzione trap per continuare l'esecuzione anziché uscire dal ciclo 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 negli 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 $ErrorActionPreference sul valore archiviato in EAP.

Per altre informazioni sull'istruzione del ciclo Windows PowerShell ForEach standard, digitare Get-Help about_ForEach.

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 tale 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 è in stato spento, 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 AutomaticCriticalErrorActionTimeout . I valori accettabili per questo parametro sono: Sospendere e None.

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

-AutomaticCriticalErrorActionTimeout

Specifica la quantità di tempo, in minuti, per attendere in pausa critica prima di disattivare la macchina virtuale.

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

-AvailabilitySetNames

Specifica un elenco di nomi dei set di disponibilità.

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

-BlockDynamicOptimization

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

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

-BootOrder

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

CD
IDEHardDrive
PXEBoot
Floppy

Type:	BootDevice[]
Accepted values:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapabilityProfile

Specifica un oggetto profilo di funzionalità.

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

-CheckpointType

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

Disabled
Produzione
ProductionOnly
Standard

Type:	CheckpointType
Accepted values:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearDRProtection

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

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

-Cloud

Specifica un oggetto cloud privato.

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

-ClusterNonPossibleOwner

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

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

-ClusterPreferredOwner

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

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

-CostCenter

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

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

-CPUCount

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

Hyper-V. Fino a quattro CPU per macchina virtuale, a seconda del sistema operativo guest.
VMware ESX. Fino a quattro CPU per ogni 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.

Type:	Byte
Aliases:	ProcessorCount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Aliases:	ExpectedCPUUtilization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 realizzati da produttori diversi.

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

-CPULimitFunctionality

Indica se fornire funzionalità 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 ESX VMware.

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

-CPUMaximumPercent

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

Type:	Int32
Aliases:	CPUMax
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUPerVirtualNumaNodeMaximum

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

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

-CPURelativeWeight

Specifica la quantità di risorse della CPU di un host che una macchina virtuale può utilizzare rispetto ad altre macchine virtuali nello stesso host. Una macchina virtuale con un valore di peso maggiore viene allocata più risorse CPU di 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. Elevata. 2000.
VMware ESX. Sopra normale. 1500.
VMware ESX. Normale (impostazione predefinita). 1000.
VMware ESX. Sotto Normale. 750.
VMware ESX. Bassa. 500.
VMware ESX. Personalizzato da 1 a 1000000.
Citrix XenServer. 1 a 65536, tipico è 256.

Type:	Int32
Aliases:	RelativeWeight
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUReserve

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

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

-CPUType

Specifica il tipo di CPU di 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 .

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