Sdílet prostřednictvím

New-SCVMHostProfile

  • Reference
Modul:
VirtualMachineManager

Vytvoří profil hostitele.

Syntaxe

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 použité 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 $OrigHostProfile proměnné.

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 $DomainJoinCreds proměnné.

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
Typ:Script
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Baseline

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

Typ:Baseline[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BypassVHDConversion

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CodeIntegrityPolicy

Určuje zásadu integrity kódu.

Typ:CodeIntegrityPolicy
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ComputerAccessRunAsAccount

Určuje účet Spustit jako počítače, 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.

Typ:RunAsAccount
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje popis profilu hostitele.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DiskConfiguration

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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"

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DomainJoinRunAsAccount

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

Typ:RunAsAccount
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DriverMatchingTag

Určuje vlastní značky, které se mají při nasazení shodovat s vlastnostmi ovladače. Po zadání značek se proces nasazení shoduje se značkami zadanými v profilu hostitele se značkami v ovladačích, aby bylo možné stáhnout odpovídající ovladače a nainstalovat je do cílové image.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FullName

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GuiRunOnceCommands

Určuje pole příkazů, které se mají přidat do oddílu [GuiRunOnce] souboru bezobslužné odpovědi. Kolem každého řetězce uzavřeného do dvojitých uvozovek použijte 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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsGuarded

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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é spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JoinWorkgroup

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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ů v nové nebo existující šabloně, 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.

Typ:VMMCredential
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název objektu VMM.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OrganizationName

Určuje název organizace osoby, jejíž jméno je virtuální počítač zaregistrovaný.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Owner

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

  • Příklad formátu: -Owner "Contoso\PattiFuller"
  • Příklad formátu: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeZone

Určuje číslo (index), které identifikuje geografickou oblast, která sdílí stejný standardní čas. Seznam indexů časových pásem najdete v tématu Hodnoty indexu časových pásem společnosti Microsoft na 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 zadání standardního časového pásma GMT: -TimeZone 085

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualHardDisk

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

Typ:VirtualHardDisk
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMHostNetworkAdapterProfile

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

Typ:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMHostProfile

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

Typ:PhysicalComputerProfile
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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ího počítače.

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

HostProfile

Tato rutina vrátí objekt HostProfile.