Set-SCVMHostProfile
修改主機設定檔的屬性。
Syntax
Set-SCVMHostProfile
-VMHostProfile <PhysicalComputerProfile>
[-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
[[-Name] <String>]
[-VirtualHardDisk <VirtualHardDisk>]
[-Domain <String>]
[-DomainJoinRunAsAccount <RunAsAccount>]
[-LocalAdministratorCredential <VMMCredential>]
[-RemoveAnswerFile]
[-RemoveGuiRunOnceCommands]
[-Description <String>]
[-Owner <String>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-GuiRunOnceCommands <String[]>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-AnswerFile <Script>]
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
Set-SCVMHostProfile Cmdlet 會修改主機設定檔的屬性。
如需如何建立主機設定檔的資訊，請輸入 Get-Help New-SCVMHostProfile -Detailed 。
範例
範例 1：設定指定主機設定檔的時區值
PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035此命令會取得名為 HostProfile01 的主機設定檔物件，並將其時區值設定為美國東部時區 (035) 。
範例 2：將主機網路介面卡設定檔新增至主機設定檔
PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf第一個命令會取得名為 HostProfile01 的主機設定檔物件，並將物件儲存在$VMHostProfile變數中。
第二個命令會取得識別碼為 259f47c7-c5a9-429d-a421-d232f9b34991 的主網路介面卡設定檔物件，並將物件儲存在$HostNetAdapterProf變數中。
最後一個命令會將儲存在 $HostNetAdapterProf 的主機網路介面卡設定檔新增至 HostProfile01。
參數
-AnswerFile
指定使用存放在 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainJoinRunAsAccount
指定具有加入指定網域許可權的執行身分帳戶。
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-LocalAdministratorCredential
在 Linux 相容的客體作業系統設定檔) 的情況下，指定本機系統管理員帳戶 (或 Linux 根帳號的使用者名稱和密碼。
在新的或現有的範本、新的或現有的客體作業系統設定檔上或新的虛擬機器上指定認證，會覆寫任何現有的系統管理員密碼。
| Type: | VMMCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定 VMM 物件的名稱。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| 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 |
-RemoveAnswerFile
表示此作業會從主機設定檔中移除回應檔案。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveGuiRunOnceCommands
此作業會從主機設定檔中移除 GUI 執行一次命令屬性。
| Type: | SwitchParameter |
| 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: | False |
| 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 物件。