New-SCVMHostProfile
创建主机配置文件。
语法
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>] 说明
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变量中。
第四个命令获取 ID 为 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
指定 基线 对象的数组。
| 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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令 shell。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeZone
指定一个数字 (索引) ，该索引标识共享同一标准时间的地理区域。
有关时区索引的列表，请参阅 Microsoft 时区索引值。http://go.microsoft.com/fwlink/?LinkId=120935
如果未指定时区，则用于虚拟机的默认时区是虚拟机主机上的同一时区设置。
指定 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 对象。