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 del fuso orario sul fuso orario degli Stati Uniti orientali (035).
Esempio 2: Aggiungere un profilo della 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 utilizzare 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 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Baseline
Specifica una matrice di oggetti Baseline .
Type: | Baseline[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BypassVHDConversion
Indica se un disco rigido virtuale dinamico collegato a un profilo host non viene convertito in un tipo fisso durante la distribuzione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CodeIntegrityPolicy
Specifica un criterio di integrità del codice.
Type: | CodeIntegrityPolicy |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerAccessRunAsAccount
Specifica l'account RunAs del computer da usare per distribuire il computer. Questo account RunAs verrà aggiunto al computer come amministratore locale e usato per gestire il computer.
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specifica una descrizione per il profilo host.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskConfiguration
Specifica la configurazione del disco e della partizione per il computer fisico che deve essere distribuito con Windows Hyper-V.
Type: | String |
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 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainJoinRunAsAccount
Specifica un account RunAs che dispone dell'autorizzazione per l'aggiunta al dominio specificato.
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverMatchingTag
Specifica i tag personalizzati da associare alle proprietà del driver durante la distribuzione. Quando i tag vengono specificati, 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.
Type: | System.Collections.Generic.List`1[System.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 |
-IsGuarded
Indica che l'host deve essere un host sorvegliato.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Specifica un ID per una serie di comandi che verranno eseguiti come set appena prima dell'esecuzione dello stesso ID 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 |
-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 |
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: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrganizationName
Specifica il nome dell'organizzazione per la persona nel cui nome viene registrata una macchina virtuale.
Type: | String |
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 |
-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 |
-RemoveAnswerFile
Indica che questa operazione rimuove il file di risposta dal profilo host.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveGuiRunOnceCommands
India che questa operazione rimuove la proprietà Run Once Commands della GUI da un profilo host.
Type: | SwitchParameter |
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 alla shell dei comandi.
Type: | SwitchParameter |
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 |
-VirtualHardDisk
Specifica un oggetto disco rigido virtuale.
Type: | VirtualHardDisk |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostNetworkAdapterProfile
Specifica una matrice di oggetti profilo scheda di rete host.
Type: | PhysicalComputerNetworkAdapterProfile[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostProfile
Specifica un oggetto profilo host della macchina virtuale.
Type: | PhysicalComputerProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMMServer
Specifica un oggetto server Virtual Machine Manager.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMPaths
Specifica una serie di percorsi predefiniti (come stringhe separate da operatori barra verticale) da utilizzare per l'archiviazione di file di macchina virtuale in un host specifico.
Formato di esempio: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Output
HostProfile[]
Questo cmdlet restituisce uno o più oggetti HostProfile .