New-SCVMHostProfile

模組:

VirtualMachineManager

建立主機設定檔。

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

New-SCVMHostProfile Cmdlet 會建立主機設定檔。 主機設定檔包含用來將實體電腦部署為 Hyper-V 主機的硬體和作業系統組態設定。

建立主機設定檔之前，請確定您指定的虛擬硬碟 (.vhd) 檔案存在於程式庫共用中。

範例

範例 1：建立主機設定檔

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

第一個命令會取得名為 VHD01.vhd 的虛擬硬碟物件，並將物件儲存在$VHD變數中。

第二個命令會提示您輸入認證。 在提示字元中，輸入系統管理員帳戶的認證。 命令會將認證儲存在 $Credential 變數中。

第三個命令會使用儲存在 $VHD 中的虛擬硬碟，以及儲存在 $Credential 中的認證，建立名為 HostProfile01 的主機設定檔。

最後一個命令會顯示新建立主機設定檔的相關資訊給使用者。

範例 2：複製現有的主機設定檔

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

第一個命令會取得名為 HostProfile01 的主機設定檔物件，並將物件儲存在$OrigHostProfile變數中。

第二個命令會複製儲存在 $OrigHostProfile 中的主機設定檔、指定的名稱，並將新的設定檔物件儲存在$NewHostProfile變數中。

範例 3：建立包含主機網路介面卡設定檔的主機設定檔

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

第一個命令會取得名為 VHDX01.vhdx 的虛擬硬碟物件，並將物件儲存在$VHDX變數中。

第二個命令會取得名為 DomainJoinRAA 的執行身分帳戶物件，並將物件儲存在$DomainJoinCreds變數中。

第三個命令會提示使用者輸入本機系統管理員認證，並將提供的認證儲存在 $LocalAdminCreds 變數中。

第四個命令會取得識別碼為 259f47c7-c5a9-429d-a421-d232f9b34991 的主網路介面卡設定檔物件，並將物件儲存在 $HostNetAdapterProf 變數中。

最後一個命令會使用 VHDX01 和儲存在 $HostNetAdapterProf 中的主機網路介面卡設定檔，建立名為 Host Profile 03 的主機設定檔。

參數

-AnswerFile

指定儲存在 Virtual Machine Manager (VMM) 程式庫中的腳本物件，以作為回應檔案使用。 回應檔案指令碼的名稱視您要在虛擬機器上安裝的作業系統而異：

• Sysprep.inf。 Windows XP、Windows Server 2000 或 Windows Server 2003
• Unattend.xml。 Windows Vista、Windows 7 或 Windows Server 2008

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

-Baseline

指定 Baseline 物件的陣列。

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

-BypassVHDConversion

指出在部署期間，附加至主機設定檔的動態 VHD 是否不會轉換成固定類型。

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

-CodeIntegrityPolicy

指定程式碼完整性原則。

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

-ComputerAccessRunAsAccount

指定要用來部署電腦的電腦存取執行身分帳戶。 此執行身分帳戶會以本機系統管理員身分新增至電腦，並用來管理電腦。

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

-Description

指定主機設定檔的描述。

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

-DiskConfiguration

指定要使用 Windows Hyper-V 部署之實體電腦的磁片和資料分割組態。

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

-Domain

指定 Active Directory 網域的完整網域名稱 (FQDN)。

範例格式： -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

指定具有加入指定網域許可權的執行身分帳戶。

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

-DriverMatchingTag

指定要在部署期間與驅動程式屬性相符的自訂標籤。 指定標記時，部署程式會比對主機設定檔中指定的標記與驅動程式中的標記，以下載相符的驅動程式，並在目標映射中安裝它們。

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

-FullName

指定虛擬機器註冊者的名稱。

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

-GuiRunOnceCommands

指定要新增至自動回應檔案 之 [GuiRunOnce] 區段的命令陣列。 在每個以雙引號括住的字串周圍使用單引號。

範例格式： -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

如需Windows PowerShell如何使用引號的資訊，請輸入 Get-Help about_Quoting_Rules 。

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

-IsGuarded

表示主機必須是受防護主機。

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

-JobGroup

指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。

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

-JobVariable

指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。

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

-JoinWorkgroup

表示此作業會聯結工作組。

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

-LocalAdministratorCredential

在 Linux 相容的客體作業系統設定檔) 的情況下，指定本機系統管理員帳戶 (或 Linux 根帳號的使用者名稱和密碼。

在新的或現有的範本、新的或現有的客體作業系統設定檔上或新的虛擬機器上指定認證，會覆寫任何現有的系統管理員密碼。

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

-Name

指定 VMM 物件的名稱。

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

-OrganizationName

為註冊虛擬機器名稱的人員指定組織名稱。

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

-Owner

以有效網域使用者帳戶的格式指定 VMM 物件的擁有者。

• 範例格式： -Owner "Contoso\PattiFuller"
• 範例格式： -Owner "PattiFuller@Contoso"

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

-ProductKey

指定產品金鑰。 產品金鑰是識別產品授權的一組 25 位數的數字。 產品金鑰可用來註冊要安裝在虛擬機器或主機上的 VMM 或作業系統。

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

-PROTipID

指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。

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

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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

-TimeZone

指定 (索引) 的數位，識別共用相同標準時間的地理區域。 如需時區索引的清單，請參閱 中的 http://go.microsoft.com/fwlink/?LinkId=120935Microsoft 時區索引值。 如果未指定時區，則用於虛擬機器的預設時區是虛擬機器主機上的相同時區設定。

指定 GMT 標準時區的範例格式： -TimeZone 085

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

-VirtualHardDisk

指定虛擬硬碟物件。

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

-VMHostNetworkAdapterProfile

指定主機網路介面卡設定檔物件。

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

-VMHostProfile

指定虛擬機器主機設定檔物件。

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

-VMMServer

指定 VMM 伺服器物件。

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

-VMPaths

指定主機上可存放虛擬機器檔案的一組預設路徑 (由管線運算子所分隔的字串)。

範例格式： -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

輸出

HostProfile

此 Cmdlet 會傳回 HostProfile 物件。

相關連結

• Get-SCRunAsAccount
• Get-SCVirtualHardDisk
• Get-SCVMHostNetworkAdapterProfile
• Get-SCVMHostProfile
• Remove-SCVMHostProfile
• Set-SCVMHostProfile