Condividi tramite


Set-SCVMHostProfile

Modifica le proprietà di un profilo host.

Sintassi

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-Description <String>]
   [-Owner <String>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-AnswerFile <Script>]
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SCVMHostProfile modifica le proprietà di un profilo host.

Per informazioni su come creare un profilo host, digitare Get-Help New-SCVMHostProfile -Detailed.

Esempio

Esempio 1: Impostare il valore del fuso orario per un profilo host specificato

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Questo comando ottiene l'oggetto profilo host denominato HostProfile01 e imposta il relativo valore di fuso orario sul fuso orario degli Stati Uniti orientali (035).

Esempio 2: Aggiungere un profilo scheda di rete host a un profilo host

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

Il primo comando ottiene l'oggetto profilo host denominato HostProfile01 e archivia l'oggetto nella variabile $VMHostProfile.

Il secondo comando ottiene l'oggetto profilo scheda di rete host con l'ID 259f47c7-c5a9-429d-a421-d232f9b34991 e archivia l'oggetto nella variabile $HostNetAdapterProf.

L'ultimo comando aggiunge il profilo della scheda di rete host archiviato in $HostNetAdapterProf a HostProfile01.

Parametri

-AnswerFile

Specifica un oggetto script archiviato nella libreria VMM da usare come file di risposte. Il nome dello script del file di risposte dipende dal sistema operativo che si vuole 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
Tipo:Script
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Baseline

Specifica una matrice di oggetti baseline.

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

-BypassVHDConversion

Indica se un disco rigido virtuale dinamico collegato a un profilo host non viene convertito in un tipo fisso durante la distribuzione.

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

-CodeIntegrityPolicy

Specifica un criterio di integrità del codice.

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

-ComputerAccessRunAsAccount

Specifica l'account RunAs di accesso al computer da usare per distribuire il computer. Questo account RunAs verrà aggiunto al computer come amministratore locale e usato per gestire il computer.

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

-Description

Specifica una descrizione per il profilo host.

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

-DiskConfiguration

Specifica la configurazione del disco e della partizione per il computer fisico da distribuire con Windows Hyper-V.

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

-Domain

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

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

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

-DomainJoinRunAsAccount

Specifica un account RunAs che dispone dell'autorizzazione per l'aggiunta al dominio specificato.

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

-DriverMatchingTag

Specifica i tag personalizzati da associare alle proprietà del driver durante la distribuzione. Quando vengono specificati tag, il processo di distribuzione corrisponde ai tag specificati nel profilo host con i tag nei driver per scaricare i driver corrispondenti e installarli nell'immagine di destinazione.

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

-FullName

Specifica il nome della persona nel cui nome è registrata una macchina virtuale.

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

-GuiRunOnceCommands

Specifica una matrice di comandi da aggiungere alla [GuiRunOnce] sezione di un file di risposte 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 le virgolette, digitare Get-Help about_Quoting_Rules.

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

-IsGuarded

Indica che l'host deve essere un host sorvegliato.

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

-JobGroup

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

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

-JobVariable

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

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

-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).

Se si specificano le credenziali in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale, viene ignorata qualsiasi password amministratore esistente.

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

-Name

Specifica il nome di un oggetto VMM.

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

-OrganizationName

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

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

-Owner

Specifica il proprietario di un oggetto VMM sotto forma di account utente di dominio valido.

  • Formato di esempio: -Owner "Contoso\PattiFuller"
  • Formato di esempio: -Owner "PattiFuller@Contoso"
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProductKey

Specifica un codice Product Key. Il codice Product Key è un numero di 25 cifre che identifica la licenza del prodotto. Un codice Product Key può essere usato per registrare VMM o un sistema operativo da installare in una macchina virtuale o in un host.

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

-PROTipID

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

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

-RemoveAnswerFile

Indica che questa operazione rimuove il file di risposte dal profilo host.

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

-RemoveGuiRunOnceCommands

India che questa operazione rimuove la proprietà Run Once Commands gui da un profilo host.

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

-RunAsynchronously

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

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

-TimeZone

Specifica un numero (indice) che identifica un'area geografica che condivide la stessa ora solare. Per un elenco degli indici del fuso orario, vedere Microsoft Time Zone Index Values in http://go.microsoft.com/fwlink/?LinkId=120935. Se non viene specificato alcun fuso orario, il fuso orario predefinito usato per una macchina virtuale corrisponde all'impostazione del fuso orario presente nell'host della macchina virtuale.

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

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

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

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

-VMHostNetworkAdapterProfile

Specifica una matrice di oggetti profilo scheda di rete host.

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

-VMHostProfile

Specifica un oggetto profilo host della macchina virtuale.

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

-VMMServer

Specifica un oggetto server VMM.

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

-VMPaths

Specifica un set di percorsi predefiniti (come stringhe separate dall'operatore della pipeline) in un host in cui è possibile archiviare i file della macchina virtuale.

Formato di esempio: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Output

HostProfile[]

Questo cmdlet restituisce uno o più oggetti HostProfile .