Share via


Set-SCVMTemplate

Modifica le proprietà di un modello di macchina virtuale usata in VMM.

Sintassi

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile \<Boolean\>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled \<Boolean\>]
   [-HighlyAvailable \<Boolean\>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired \<Boolean\>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled \<Boolean\>]
   [-NumLock \<Boolean\>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano \<Boolean\>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-UserRole <UserRole>]
   [-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>]
   [<CommonParameters>]
Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile \<Boolean\>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled \<Boolean\>]
   [-HighlyAvailable \<Boolean\>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired \<Boolean\>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled \<Boolean\>]
   [-NumLock \<Boolean\>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano \<Boolean\>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-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>]
   [<CommonParameters>]

Descrizione

Nota

Un nuovo parametro [-EnableNestedVirtualization] <Boolean> è incluso in VMM 2019 UR1 e versioni successive. Per altre informazioni, vedere Parametri.

Il cmdlet Set-SCVMTemplate modifica una o più proprietà di un modello di macchina virtuale usata in un ambiente VMM (Virtual Machine Manager).

Le proprietà che è possibile modificare includono le impostazioni per il nome del modello, la descrizione, il proprietario, il nome dell'organizzazione, il fuso orario, il sistema operativo e il codice Product Key; Ordine di avvio BIOS; Numero e caratteristiche della CPU; quantità di memoria nell'host assegnato a una macchina virtuale; la quantità di larghezza di banda nella rete dell'host disponibile per una macchina virtuale; se una macchina virtuale creata con questo modello sarà a disponibilità elevata (ad esempio, distribuita in un host che fa parte di un cluster host); valori per dominio o gruppo di lavoro e credenziali di dominio; una quota di punti che specifica il numero di nuove macchine virtuali che gli utenti self-service possono creare; campi personalizzati; e altre opzioni.

Le modifiche apportate a un modello influiscono solo sul modello. Le modifiche non influiscono sulle macchine virtuali esistenti create in precedenza usando questo modello.

Se si desidera modificare le proprietà di un'unità disco virtuale, un'unità floppy virtuale, un'unità DVD virtuale, una scheda di rete virtuale, una scheda SCSI virtuale o una porta COM virtuale associata a un modello specifico, è possibile usare rispettivamente i cmdlet Set-SCVirtualDiskDrive, Set-SCVirtualFloppyDrive, Set-SCVirtualNetworkAdapter, Set-SCVirtualScsiAdapter o Set-SCVirtualCOMPort.

Esempio

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

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -MemoryMB 1024

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato VMTemplate01 dalla libreria VMM e archivia l'oggetto nella variabile $Template.

Il secondo comando modifica il valore di memoria per VMTemplate01 a 1024 MB. Si tratta della quantità di memoria nell'host che verrà usata da una macchina virtuale creata tramite questo modello.

Esempio 2: Specificare un nuovo proprietario per più modelli di macchina virtuale a disponibilità elevata

PS C:\> $VMTemplates = Get-SCVMTemplate | where {$_.IsHighlyAvailable}
PS C:\> ForEach ($VMTemplate in $VMTemplates) {Set-SCVMTemplate $VMTemplate -Owner "Contoso\NevenSokec"}

Il primo comando ottiene tutti gli oggetti modello di macchina virtuale a disponibilità elevata e archivia gli oggetti nella matrice di oggetti $VMTemplates.

Il secondo comando usa un ciclo ForEach per specificare un nuovo proprietario per ognuno dei modelli nella matrice $VMTemplates.

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

Esempio 3: Specificare un nuovo proprietario per tutti i modelli di macchina virtuale con lo stesso proprietario

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

Questo comando ottiene tutti gli oggetti modello di macchina virtuale dalla libreria VMM, seleziona solo gli oggetti il cui proprietario è "Contoso\PattiFuller" e quindi passa ogni oggetto al cmdlet Set-SCVMTemplate , che modifica il proprietario in Contoso|AllieSloan.

Esempio 4: Abilitare la memoria dinamica per un modello di macchina virtuale esistente

PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate04"}
PS C:\> Set-SCVMTemplate -VMTemplate $VMTemplate -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato VMTemplate04 dalla libreria VMM e archivia l'oggetto nella variabile $VMTemplate.

Il secondo comando abilita la memoria dinamica, modifica il valore di memoria di avvio per VMTemplate04 a 1024 MB (si tratta della quantità di memoria nell'host che una macchina virtuale creata usando questo modello viene allocata all'avvio) e imposta il valore massimo di memoria su 2048 MB (si tratta della quantità massima di memoria che può essere allocata a una macchina virtuale creata con questo modello). Una macchina virtuale che usa memoria dinamica può essere distribuita solo in un host che esegue Windows Server 2008 R2 SP1 o versione successiva.

Esempio 5: Specificare la password radice per un modello di macchina virtuale Linux personalizzabile esistente

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "LinuxVMTemplate01"}
PS C:\> $Creds = Get-Credential
PS C:\> Set-SCVMTemplate -Template $Template -LocalAdministratorCredential $Creds

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato LinuxVMTemplate01 dalla libreria VMM e archivia l'oggetto nella variabile $Template.

Il secondo comando ottiene un nome utente (radice) e una password tramite il comando Get-Credential e archivia il risultato nella variabile $Creds.

L'ultimo comando imposta la password dell'account radice sulla password archiviata nella variabile $Creds.

Esempio 6: Abilitare le funzionalità di gestione degli aggiornamenti di Azure in un modello di macchina virtuale esistente.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $azureProfile = Get-SCAzureProfile | where { $_.Name -eq "AzUpdateMgmtProfile"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $azureProfile

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato VMTemplate01 dalla libreria VMM e archivia l'oggetto nella variabile $Template.

Il secondo comando ottiene un profilo di gestione degli aggiornamenti di Azure dalla libreria VMM e archivia l'oggetto nella variabile $azureProfile.

Il terzo comando abilita il modello con le funzionalità di gestione degli aggiornamenti di Azure collegando un profilo di Azure.

Esempio 7: Disabilitare le funzionalità di gestione degli aggiornamenti di Azure in un modello di macchina virtuale.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $null

Il primo comando ottiene l'oggetto modello di macchina virtuale denominato VMTemplate01 dalla libreria VMM e archivia l'oggetto nella variabile $Template.

Il secondo comando disabilita il modello con le funzionalità di gestione degli aggiornamenti di Azure.

Parametri

-AnswerFile

Specifica un oggetto script archiviato nella libreria VMM (Virtual Machine Manager) da usare come file di risposte. Il nome di tale file di risposte dipende dal sistema operativo che si desidera installare in una macchina virtuale:

  • Sysprep.inf. Windows XP, Windows Server 2000 o Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 o Windows Server 2008
Type:Script
Aliases:SysPrepFile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationProfile

Specifica un oggetto profilo applicazione.

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

-AutoLogonCount

Specifica il numero di volte in cui Windows deve registrare automaticamente l'amministratore indicato nel file di risposte nella sessione della console.

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

-AutoLogonCredential

Specifica l'account RunAs contenuto nel file di risposte usato da Windows per accedere alla sessione della console quando è abilitato l'accesso automatico dell'amministratore.

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

-AutomaticCriticalErrorAction

Specifica l'azione da eseguire quando la macchina virtuale rileva un errore critico e supera la durata di timeout specificata dal parametro AutomaticCriticalErrorActionTimeout . I valori accettabili per questo parametro sono: Pause 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, espressa in minuti, di attesa in pausa critica prima di spegnere la macchina virtuale.

Type:Int32
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 l'avvio. 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 di protezione del ripristino di emergenza.

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

-ComputerName

Specifica il nome di un computer identificabile in modo univoco da VMM nella rete. I valori validi per questo parametro sono:

  • Nome di dominio completo
  • Indirizzo IPv4 o IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Specifica il centro di costo per una macchina virtuale al fine di consentire la raccolta dei dati sull'allocazione delle macchine virtuali (o sulle risorse allocate alle macchine virtuali), da utilizzare nel sistema di fatturazione dell'azienda.

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

-CPUCount

Specifica il numero di CPU presenti in una macchina virtuale, un profilo hardware o un modello.

I tipi di host supportano il numero di CPU 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, ma solo 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 utilizzato esclusivamente quando Virtual Machine Manager seleziona un host adatto 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 abilitare l'esecuzione di 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, fornendo funzionalità di CPU limitate per la macchina virtuale.

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 utilizzabili da una macchina virtuale specifica in un determinato momento.

Esempio: -CPUMaximumPercent 80 (per specificare l'80%)

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 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. Elevata. 2000.
  • VMware ESX. Al di sopra del 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, normale è 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 a una 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 recuperare un elenco di tutti i tipi di CPU disponibili per l'uso nelle macchine virtuali in un ambiente VMM, digitare Get-SCCPUType.

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

-Custom1

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom10

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom2

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom3

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom4

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom5

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom6

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom7

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom8

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-Custom9

Specifica una proprietà personalizzata in un modello di macchina virtuale.

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Specifica una descrizione per il modello di macchina virtuale.

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

-DisableAutoLogon

Disabilita l'accesso automatico dell'amministratore.

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

-DiskIops

Specifica il numero di operazioni di input/output su disco al secondo nell'host utilizzabili da una macchina virtuale specifica.

Esempio: -DiskIO 1500 (per specificare 1500 operazioni di I/O al secondo)

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

-Domain

Specifica un nome di dominio completo (FQDN) per un dominio Active Directory.

Formato di esempio: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinCredential

Specifica il nome utente e la password di un account che dispone dell'autorizzazione per aggiungere un computer al dominio. È consigliabile usare un account di diritti limitato che aggiunge computer al dominio. Ciò include sia computer virtuali che fisici.

È possibile usare il parametro corrente per specificare le credenziali in un vmHostProfile per aggiungere un computer host fisico al dominio oppure specificare le credenziali, in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale, per l'aggiunta di una macchina virtuale al dominio.

Type:VMMCredential
Aliases:JoinDomainCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinOrganizationalUnit

Specifica l'unità organizzativa a cui viene aggiunto il computer durante un mini-setup automatico.

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

-DRProtectionRequired

Questo parametro è riservato per usi futuri.

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

-DynamicMemoryBufferPercentage

Specifica la percentuale di memoria precedente all'allocazione di memoria corrente di una macchina virtuale che l'host deve provare a riservare come buffer. Il valore predefinito è 20.

Formato di esempio: -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

Indica se abilitare la memoria dinamica per le macchine virtuali. È possibile abilitare la memoria dinamica direttamente in una macchina virtuale o in un modello o in un profilo hardware usato per creare macchine virtuali. Il valore predefinito è False.

Obbligatorio: è possibile abilitare la memoria dinamica per una macchina virtuale solo se tale macchina virtuale viene distribuita in un host che esegue Windows Server 2008 SP1 o versione successiva o se la macchina virtuale viene archiviata in una libreria in uno stato arrestato (è possibile apportare modifiche hardware a una macchina virtuale archiviata solo se la macchina virtuale non dispone di snapshot). Abilitazione della memoria dinamica in una macchina virtuale archiviata in una libreria limita il posizionamento di tale computer agli host che eseguono Windows Server 2008 SP1 o versioni successive.

Formato di esempio: -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

Specifica la quantità massima di memoria che può essere allocata a una macchina virtuale se è abilitata la memoria dinamica. Il valore predefinito è 65536.

Obbligatorio: è possibile abilitare la memoria dinamica per una macchina virtuale solo se tale macchina virtuale viene distribuita in un host che esegue Windows Server 2008 R2 SP1 o versione successiva o se la macchina virtuale viene archiviata in una libreria in uno stato arrestato (è possibile apportare modifiche hardware a una macchina virtuale archiviata solo se la macchina virtuale non dispone di snapshot). L'abilitazione della memoria dinamica in una macchina virtuale archiviata in una libreria limiterà la selezione host della macchina agli host in cui è in esecuzione Windows Server 2008 R2 SP1 o versioni successive.

Formato di esempio: -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

Specifica la quantità minima di memoria che può essere allocata a una macchina virtuale se è abilitata la memoria dinamica. Il valore predefinito è 65536.

Obbligatorio: è possibile abilitare la memoria dinamica per una macchina virtuale solo se tale macchina virtuale viene distribuita in un host che esegue Windows Server 2008 R2 SP1 o versione successiva o se la macchina virtuale viene archiviata in una libreria in uno stato arrestato (è possibile apportare modifiche hardware a una macchina virtuale archiviata solo se la macchina virtuale non dispone di snapshot). L'abilitazione della memoria dinamica in una macchina virtuale archiviata in una libreria limiterà la selezione host della macchina agli host in cui è in esecuzione Windows Server 2008 R2 SP1 o versioni successive.

Formato di esempio: -DynamicMemoryMinimumMB 1024

Type:Int32
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

-EnableNestedVirtualization

Abilita la virtualizzazione annidata.

Nota

Questo parametro è applicabile per VMM 2019 UR1 e versioni successive.

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

-FirstBootDevice

Specifica il dispositivo in cui viene eseguito il primo tentativo di avvio.

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

-FullName

Specifica il nome di persona utilizzato per la registrazione della macchina virtuale,

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

-GuiRunOnceCommands

Specifica una matrice di comandi da aggiungere alla sezione [GuiRunOnce] di un file di risposta automatica. Usare virgolette singole intorno a ogni stringa racchiusa tra virgolette doppie.

Formato di esempio: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Per informazioni su come Windows PowerShell usa virgolette, digitare Get-Help about_Quoting_Rules.

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

-HAVMPriority

Specifica la priorità della macchina virtuale. Le macchine virtuali iniziano con priorità fino ai limiti di un nodo del cluster host. L'input valido per questo parametro è una rappresentazione numerica della priorità:

  • Elevata. 3000
  • Media. 2000
  • Bassa. 1000

Se si specifica un valore pari a zero (0), la macchina virtuale non viene riavviata automaticamente.

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

-HighlyAvailable

Indica se inserire una macchina virtuale in un host Hyper-V che fa parte di un cluster host. Configurare questa impostazione in una macchina virtuale, un modello o un profilo hardware utilizzato per creare macchine virtuali.

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

-JobGroup

Specifica un identificatore per una serie di comandi eseguiti come set appena prima dell'esecuzione dello stesso identificatore del 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

-LinuxAdministratorSSHKey

Specifica il file di chiave pubblica per una chiave SSH Linux.

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

-LinuxAdministratorSSHKeyString

Specifica una chiave SSH amministratore Linux come stringa.

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

-LinuxDomainName

Specifica un nome di dominio completo (FQDN) da usare insieme alla specializzazione del sistema operativo Linux.

Formato di esempio: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

Specifica il nome utente e la password per l'account amministratore locale (o l'account radice Linux nel caso di un profilo del sistema operativo guest compatibile con Linux).

Specificare le credenziali in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale esegue l'override di qualsiasi password amministratore esistente.

Type:VMMCredential
Aliases:AdminPasswordCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemoryMB

Specifica la quantità di memoria di accesso casuale (RAM), in megabyte (MB), nell'host che questo cmdlet alloca alla macchina virtuale convertita. Il valore predefinito è 512 MB. Per una macchina virtuale in cui è abilitata la memoria dinamica in un host che esegue Windows Server 2008 R2 SP1 o versioni successive, specificare il valore di memoria di avvio.

I tipi di host hanno la memoria massima assegnabile alle macchine virtuali seguenti:

  • Hyper-V. Fino a 65536 MB di RAM per macchina virtuale.
  • VMware ESX Server 3.0.x. Fino a 16384 MB di RAM per macchina virtuale.
  • VMware ESX Server 3.5.x. Fino a 65532 MB di RAM per macchina virtuale.
  • Citrix XenServer. Fino a 32265 MB di RAM per macchina virtuale.
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemoryPerVirtualNumaNodeMaximumMB

Specifica la quantità massima di memoria, in MB, consentita per ogni nodo NUMA virtuale.

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

-MemoryWeight

Indica la priorità per assegnare la memoria alla macchina virtuale, rispetto ad altre macchine virtuali nello stesso host. A una macchina virtuale con un'impostazione maggiore vengono allocate più risorse della memoria rispetto a una macchina virtuale con un'impostazione inferiore.

Per un host che esegue Windows Server 2008 R2 SP1 o versioni successive, 5000 = Normale, 10000 = Alto, 0 = Basso, 1 a 10000 = Personalizzato.

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

-MergeAnswerFile

Indica se questo cmdlet unisce il file di risposta insieme alle impostazioni del sistema operativo guest. Il valore predefinito è $True. La console VMM usa questo parametro. Non specificare questo parametro.

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

-MonitorMaximumCount

Specifica il numero massimo di monitor supportati da una scheda video virtuale.

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

-MonitorMaximumResolution

Specifica il valore, come stringa, che rappresenta la risoluzione massima possibile di monitoraggio di una scheda video virtuale. I valori validi per questo parametro sono:

  • 1024 x 768
  • 1280x1024
  • 1600 x 1200
  • 1920x1200

Il valore predefinito è 1280x1024.

Formato di esempio: -MonitorMaximumResolution "1600x1200"

Type:String
Aliases:MonitorResolutionMaximum
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

-NetworkUtilizationMbps

Specifica, in megabit al secondo (Mbps), la quantità di larghezza di banda nella rete dell'host che può essere usata da una macchina virtuale specifica.

Formato di esempio: -NetworkUtilization 10

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

-NumaIsolationRequired

Indica se è necessario l'isolamento NUMA.

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

-NumLock

Indica se abilitare il valore BIOS per NumLock in un modello usato per creare macchine virtuali in un host Hyper-V. Questo parametro non si applica alle macchine virtuali negli host ESX VMware o negli host Citrix XenServer.

Type:Boolean
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:True
Accept wildcard characters:False

-OrganizationName

Specifica il nome dell'organizzazione per la persona nel cui nome viene registrata una macchina virtuale.

Type:String
Aliases:OrgName
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

-ProtectionProvider

Specifica un provider di protezione.

Type:ProtectionProvider
Accepted values:None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
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

-QuotaPoint

Specifica una quota che limita il numero di macchine virtuali che gli utenti self-service possono distribuire.

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

-RecoveryPointObjective

Specifica il periodo massimo per il quale è tolerabile perdere dati da un servizio IT a causa di un evento imprevisto principale.

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

-RemoveCapabilityProfile

Rimuove uno o più oggetti del profilo di funzionalità specificati.

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

-RemoveDomainJoinOrganizationalUnit

Indica che questo cmdlet rimuove l'unità organizzativa aggiunta al computer durante la configurazione.

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

-RemoveServerFeatures

Indica che questo cmdlet rimuove tutti i ruoli e le funzionalità del server da un modello.

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

-ReplicationGroup

Specifica un gruppo di replica.

Type:ReplicationGroup
Position:Named
Default value:None
Required:False
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 la shell dei comandi.

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

-SecureBootEnabled

Indica se l'avvio sicuro è abilitato.

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

-SecureBootTemplate

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

-SQLProfile

Specifica un oggetto profilo SQL Server.

Type:SQLProfile
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:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeZone

Specifica un numero (indice) che identifica un'area geografica che condivide lo stesso tempo standard. Per un elenco di indici del fuso orario, vedere Valori dell'indice del fuso orario Microsoft all'indirizzo http://go.microsoft.com/fwlink/?LinkId=120935. Se non viene specificato alcun fuso orario, il fuso orario predefinito usato per una macchina virtuale è la stessa impostazione del fuso orario che si trova nell'host della macchina virtuale.

Formato di esempio per specificare il fuso orario standard GMT: -TimeZone 085

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

-UnattendSettings

Specifica una coppia chiave/valore costituita da String, String.

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

-UpdateManagementProfile

Specifica il profilo di Azure che può essere usato in VMTemplate. Il profilo di Azure offre funzionalità di co-gestione di Azure alla macchina virtuale.

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

-UserRole

Specifica un oggetto ruolo utente.

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

-VirtualNumaNodesPerSocketMaximum

Specifica il numero massimo di nodi NUMA consentiti per ogni socket.

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

-VirtualVideoAdapterEnabled

Indica se abilitare l'adattatore video virtuale 3D microsoft per le macchine virtuali. È possibile abilitare l'adapter video virtuale direttamente in una macchina virtuale o in un modello o in un profilo hardware che verrà usato per creare macchine virtuali.

Obbligatorio: è possibile abilitare l'adattatore video virtuale microsoft sintetico 3D per una macchina virtuale solo se tale macchina virtuale viene distribuita in un host che esegue Windows Server 2008 R2 SP1 (con il ruolo Servizi Desktop remoto e il servizio ruolo Grafica virtuale Desktop remoto installato) o successivamente o se la macchina virtuale viene archiviata in una libreria in uno stato arrestato (le modifiche hardware a una macchina virtuale archiviata possono essere apportate solo se la macchina virtuale virtuale è installata) il computer non dispone di snapshot. L'abilitazione dell'adattatore video virtuale 3D Microsoft in una macchina virtuale archiviata in una libreria limita la posizione di tale computer agli host che eseguono Windows Server 2008 R2 SP1 (con il ruolo Servizi Desktop remoto e il servizio ruolo Grafica virtuale Desktop remoto installato) o versioni successive.

Formato di esempio: -VirtualVideoAdapterEnabled $True

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

-VMTemplate

Specifica un oggetto modello VMM utilizzato per creare macchine virtuali.

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

-Workgroup

Specifica in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale il nome del gruppo di lavoro a cui si vuole aggiungere una macchina virtuale. È possibile utilizzare questo parametro per sostituire il valore esistente in un modello o un profilo del sistema operativo guest.

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

Output

Template

Questo cmdlet restituisce un oggetto Template .

Note

  • Richiede un oggetto modello di macchina virtuale VMM, che può essere recuperato usando il cmdlet Get-SCVMTemplate .