Sdílet prostřednictvím

New-SCVMHostProfile

  • Reference
Modul:
VirtualMachineManager

Vytvoří profil hostitele.

Syntax

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>]

Description

Rutina New-SCVMHostProfile vytvoří profil hostitele. Profily hostitelů obsahují nastavení konfigurace hardwaru a operačního systému sloužící k nasazení fyzického počítače jako hostitele Hyper-V.

Před vytvořením profilu hostitele se ujistěte, že soubor virtuálního pevného disku (.vhd), který zadáte, existuje ve sdílené složce knihovny.

Příklady

Příklad 1: Vytvoření profilu hostitele

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

První příkaz získá objekt virtuálního pevného disku s názvem VHD01.vhd a uloží objekt do proměnné $VHD.

Druhý příkaz vás vyzve k zadání přihlašovacích údajů. Na příkazovém řádku zadejte přihlašovací údaje účtu správce. Příkaz uloží přihlašovací údaje do proměnné $Credential.

Třetí příkaz vytvoří profil hostitele s názvem HostProfile01 pomocí virtuálního pevného disku uloženého v $VHD a přihlašovacích údajů uložených v $Credential.

Poslední příkaz zobrazí uživateli informace o nově vytvořeném profilu hostitele.

Příklad 2: Klonování existujícího profilu hostitele

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

První příkaz získá objekt profilu hostitele s názvem HostProfile01 a uloží objekt do proměnné $OrigHostProfile.

Druhý příkaz zkopíruje profil hostitele uložený v $OrigHostProfile, poskytne mu zadaný název a uloží nový objekt profilu do proměnné $NewHostProfile.

Příklad 3: Vytvoření profilu hostitele, který obsahuje profil síťového adaptéru hostitele

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

První příkaz získá objekt virtuálního pevného disku s názvem VHDX01.vhdx a uloží objekt do proměnné $VHDX.

Druhý příkaz získá objekt účtu Spustit jako s názvem DomainJoinRAA a uloží objekt do proměnné $DomainJoinCreds.

Třetí příkaz vyzve uživatele k zadání přihlašovacích údajů místního správce a uloží zadané přihlašovací údaje do proměnné $LocalAdminCreds.

Čtvrtý příkaz získá objekt profilu síťového adaptéru hostitele s ID 259f47c7-c5a9-429d-a421-d232f9b34991 a uloží objekt do proměnné $HostNetAdapterProf.

Poslední příkaz vytvoří profil hostitele s názvem Profil hostitele 03 pomocí VHDX01 a profilu síťového adaptéru hostitele uloženého v $HostNetAdapterProf.

Parametry

-AnswerFile

Určuje objekt skriptu uložený v knihovně nástroje Virtual Machine Manager (VMM), který se má použít jako soubor odpovědí. Název skriptu souboru odpovědí závisí na operačním systému, který chcete nainstalovat na virtuální počítač:

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

-Baseline

Určuje pole objektů směrného plánu .

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

-BypassVHDConversion

Označuje, zda dynamický virtuální pevný disk připojený k profilu hostitele není během nasazení převeden na pevný typ.

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

-CodeIntegrityPolicy

Určuje zásadu integrity kódu.

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

-ComputerAccessRunAsAccount

Určuje účet Spustit jako pro počítač, který se má použít k nasazení počítače. Tento účet Spustit jako se přidá do počítače jako místní správce a použije se ke správě počítače.

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

-Description

Určuje popis profilu hostitele.

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

-DiskConfiguration

Určuje konfiguraci disku a oddílu pro fyzický počítač, který se má nasadit s Windows Hyper-V.

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

-Domain

Určuje plně kvalifikovaný název domény (FQDN) pro doménu služby Active Directory.

Příklad formátu: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

Určuje účet Spustit jako, který má oprávnění připojit se k zadané doméně.

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

-DriverMatchingTag

Určuje vlastní značky, které se mají shodovat s vlastnostmi ovladače během nasazování. Při zadání značek proces nasazení odpovídá značkám zadaným v profilu hostitele se značkami v ovladačích, aby se stáhly odpovídající ovladače a nainstalovaly je do cílové image.

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

-FullName

Určuje jméno osoby, ve které je virtuální počítač zaregistrovaný.

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

-GuiRunOnceCommands

Určuje pole příkazů, které se mají přidat do části [GuiRunOnce] souboru bezobslužné odpovědi. Kolem každého řetězce uzavřeného do dvojitých uvozovek používejte jednoduché uvozovky.

Příklad formátu: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Informace o tom, jak Windows PowerShell používá uvozovky, zadejte Get-Help about_Quoting_Rules.

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

-IsGuarded

Označuje, že hostitel musí být stráženým hostitelem.

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

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-JoinWorkgroup

Označuje, že tato operace se připojí k pracovní skupině.

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

-LocalAdministratorCredential

Určuje uživatelské jméno a heslo pro účet místního správce (nebo kořenový účet Linuxu v případě profilu hostovaného operačního systému kompatibilního s Linuxem).

Zadání přihlašovacích údajů pro novou nebo existující šablonu, v novém nebo existujícím profilu hostovaného operačního systému nebo na novém virtuálním počítači přepíše jakékoli stávající heslo správce.

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

-Name

Určuje název objektu VMM.

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

-OrganizationName

Určuje název organizace osoby, ve které je virtuální počítač zaregistrovaný.

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

-Owner

Určuje vlastníka objektu VMM ve formátu platného uživatelského účtu domény.

  • Příklad formátu: -Owner "Contoso\PattiFuller"
  • Příklad formátu: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Určuje kód Product Key. Kód Product Key je 25místné číslo, které identifikuje licenci produktu. Kód Product Key lze použít k registraci nástroje VMM nebo operačního systému, který se má nainstalovat na virtuální počítač nebo hostitele.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

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

-TimeZone

Určuje číslo (index), které identifikuje geografickou oblast, která sdílí stejný standardní čas. Seznam indexů časových pásem naleznete v tématu Hodnoty indexu časových pásem společnosti Microsoft na adrese http://go.microsoft.com/fwlink/?LinkId=120935. Pokud není zadané žádné časové pásmo, výchozí časové pásmo použité pro virtuální počítač je stejné nastavení časového pásma, které je na hostiteli virtuálního počítače.

Příklad formátu pro určení standardního časového pásma GMT: -TimeZone 085

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

-VirtualHardDisk

Určuje objekt virtuálního pevného disku.

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

-VMHostNetworkAdapterProfile

Určuje objekt profilu síťového adaptéru hostitele.

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

-VMHostProfile

Určuje objekt profilu hostitele virtuálního počítače.

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

-VMMServer

Určuje objekt serveru VMM.

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

-VMPaths

Určuje sadu výchozích cest (jako řetězce oddělené operátorem kanálu) na hostiteli, kde lze ukládat soubory virtuálních počítačů.

Příklad formátu: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Výstupy

HostProfile

Tato rutina vrátí objekt HostProfile .