Share via

New-SCVMHostProfile

  • Riferimento
Modulo:
VirtualMachineManager

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 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:\> $HostProfile

Il 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 $OrigHostProfile

Il 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, fornisce il nome specificato e archivia il nuovo oggetto profilo nella variabile $NewHostProfile.

Esempio 3: Creare un profilo host che include un profilo della 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 $HostNetAdapterProf

Il 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 RunA denominato DomainJoinRAA e archivia l'oggetto nella variabile $DomainJoinCreds.

Il terzo comando richiede all'utente le credenziali dell'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 risposta. 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 viene 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:True
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:True
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 identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di 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

-JoinWorkgroup

Indica che questa operazione viene aggiunta a un gruppo di lavoro.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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:True
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:True
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

-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:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostNetworkAdapterProfile

Specifica un oggetto 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 un oggetto HostProfile .