New-SCVMHostProfile
Crea un profilo host.
Sintassi
New-SCVMHostProfile
[-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
-Domain <String>
-DomainJoinRunAsAccount <RunAsAccount>
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCVMHostProfile
-VMHostProfile <PhysicalComputerProfile>
[-Name] <String>
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCVMHostProfile
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
[-JoinWorkgroup]
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCVMHostProfile
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
-Domain <String>
-DomainJoinRunAsAccount <RunAsAccount>
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Descrizione
Il cmdlet New-SCVMHostProfile crea un profilo host. I profili host contengono le impostazioni di configurazione hardware e del sistema operativo usate per distribuire un computer fisico come host Hyper-V.
Prima di creare un profilo host, assicurarsi che il file dell'unità disco rigido virtuale (VHD) specificato esista in una condivisione di libreria.
Esempio
Esempio 1: Creare un profilo host
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfileIl primo comando ottiene l'oggetto disco rigido virtuale denominato VHD01.vhd e archivia l'oggetto nella variabile $VHD.
Il secondo comando richiede le credenziali. Al prompt immettere le credenziali di un account amministratore. Il comando archivia le credenziali nella variabile $Credential.
Il terzo comando crea un profilo host denominato HostProfile01 usando il disco rigido virtuale archiviato in $VHD e le credenziali archiviate in $Credential.
L'ultimo comando visualizza informazioni sul profilo host appena creato all'utente.
Esempio 2: Clonare un profilo host esistente
PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfileIl primo comando ottiene l'oggetto profilo host denominato HostProfile01 e archivia l'oggetto nella variabile $OrigHostProfile.
Il secondo comando copia il profilo host archiviato in $OrigHostProfile, assegna il nome specificato e archivia il nuovo oggetto profilo nella variabile $NewHostProfile.
Esempio 3: Creare un profilo host che includa un profilo scheda di rete host
PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProfIl primo comando ottiene l'oggetto disco rigido virtuale denominato VHDX01.vhdx e archivia l'oggetto nella variabile $VHDX.
Il secondo comando ottiene l'oggetto account RunAs denominato DomainJoinRAA e archivia l'oggetto nella variabile $DomainJoinCreds.
Il terzo comando richiede all'utente le credenziali di amministratore locale e archivia le credenziali specificate nella variabile $LocalAdminCreds.
Il quarto 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 crea un profilo host denominato Profilo host 03 usando VHDX01 e il profilo della scheda di rete host archiviato in $HostNetAdapterProf.
Parametri
-AnswerFile
Specifica un oggetto script archiviato nella libreria VMM (Virtual Machine Manager) 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 viene 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: | True |
| 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: | True |
| 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 identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del 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 |
-JoinWorkgroup
Indica che questa operazione viene aggiunta a un gruppo di lavoro.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| 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: | True |
| 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: | True |
| 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 |
-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: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMHostNetworkAdapterProfile
Specifica un oggetto 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 un oggetto HostProfile