共用方式為


Set-SCVMHost

修改虛擬機器主機的屬性。

Syntax

Set-SCVMHost
   [-VMHost] <Host>
   [-BMCAddress <String>]
   [-BMCRunAsAccount <RunAsAccount>]
   [-BMCPort <UInt32>]
   [-BMCProtocol <OutOfBandManagementType>]
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-ManagementAdapterMACAddress <String>]
   [-SMBiosGuid <Guid>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-ApplyLatestCodeIntegrityPolicy]
   [-BypassMaintenanceModeCheck]
   [-MaintenanceHost <Boolean>]
   [-AvailableForPlacement <Boolean>]
   [-Description <String>]
   [-OverrideHostGroupReserves <Boolean>]
   [-CPUPercentageReserve <UInt16>]
   [-NetworkPercentageReserve <UInt16>]
   [-DiskSpaceReserveMB <UInt64>]
   [-MaxDiskIOReservation <UInt64>]
   [-MemoryReserveMB <UInt64>]
   [-VMPaths <String>]
   [-BaseDiskPaths <String>]
   [-RemoteConnectEnabled <Boolean>]
   [-RemoteConnectPort <UInt32>]
   [-SecureRemoteConnectEnabled <Boolean>]
   [-RemoteConnectCertificatePath <String>]
   [-RemoveRemoteConnectCertificate]
   [-EnableLiveMigration <Boolean>]
   [-LiveMigrationMaximum <UInt32>]
   [-LiveStorageMigrationMaximum <UInt32>]
   [-UseAnyMigrationSubnet <Boolean>]
   [-MigrationSubnet <String[]>]
   [-MigrationAuthProtocol <MigrationAuthProtocolType>]
   [-MigrationPerformanceOption <MigrationPerformanceOptionType>]
   [-VMHostManagementCredential <VMMCredential>]
   [-NumaSpanningEnabled <Boolean>]
   [-FibreChannelWorldWidePortNameMinimum <String>]
   [-FibreChannelWorldWidePortNameMaximum <String>]
   [-FibreChannelWorldWideNodeName <String>]
   [-IsDedicatedToNetworkVirtualizationGateway <Boolean>]
   [-JobGroup <Guid>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCVMHost Cmdlet 會修改 Virtual Machine Manager 所管理之虛擬機器主機的一或多個屬性, (VMM) 。 您可以使用 Set-SCVMHost Cmdlet 修改的設定摘要如下:

可用性作為虛擬機器主機

您可以指定 VMM 放置程式目前是否將主機視為要放置虛擬機器的候選項目。

主機保留設定

您可以設定下列主機保留設定:

  • 要保留供主機使用的 CPU 使用量百分比。
  • (MB 的磁碟空間量) ,以供主機使用。
  • 每秒磁片 I/O 作業數目上限 (IOPS) ,以供主機使用。
  • 要保留給主機使用的記憶體量 (MB) 。
  • 要保留供主機使用的網路容量百分比。

除非可以符合虛擬機器的資源需求,而不需使用主機保留,否則 VMM 放置程式不建議將虛擬機器放在主機上。 如果您未指定保留設定,VMM 會使用預設設定。

虛擬機器路徑

您可以使用一組預設路徑來指定主機上的位置,用於存放虛擬機器檔案。

管理周邊網路或非信任網域中主機的認證

您可以指定帳戶的密碼,以管理位於周邊網路或非信任網域中的 Hyper-V 主機。

遠端連線設定

您可以設定 Hyper-V 主機的遠端連線設定, (VMConnect) ,讓使用者能夠從遠端連線到虛擬機器。 這個設定不會套用至 VMware ESX 主機上的虛擬機器。

範例

範例 1:讓主機可供放置

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -AvailableForPlacement $True

第一個命令會取得名為 VMHost01 的主機物件,並將物件儲存在$VMHost變數中。

第二個命令會讓 VMHost01 成為虛擬機器的主機。 將 AvailableForPlacement 參數設定為 True 可讓 VMM 放置程式將這個主機評估為部署虛擬機器的可能候選項目。

範例 2:在 Hyper-V 主機上啟用遠端連線

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -RemoteConnectEnabled $True -RemoteConnectPort 5900

第一個命令會取得名為 VMHost01 的主機物件,並將物件儲存在$VMHost變數中。

第二個命令會在 VMHost01 上啟用遠端連線,並將用於遠端連線的埠設定為 5900。

在 Hyper-V 主機上啟用遠端連線可讓使用者從遠端存取和管理主機上的虛擬機器。

範例 3:更新主機的虛擬機器路徑

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -VMPaths "C:\ProgramData\Microsoft\Windows\Hyper-V|D:\VirtualMachinePath"

第一個命令會取得名為 VMHost01 的主機物件,並將物件儲存在$VMHost變數中。

第二個命令會將路徑 D:\VirtualMachinePath 新增至該主機上的虛擬機器路徑清單,以更新儲存在 $VMHost 中的主機 VMPaths 屬性。

範例 4:更新主機的資源保留

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -CPUPercentageReserve 40 -DiskSpaceReserveMB 2048 -MaxDiskIOReservation 500 -MemoryReserveMB 1024 -NetworkPercentageReserve 40

第一個命令會取得名為 VMHost01 的主機物件,並將物件儲存在$VMHost變數中。

第二個命令會更新 VMHost01 的指定屬性。

範例 5:更新指定實體主機的裸機電腦使用者名稱和密碼

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCCreds"
PS C:\> Set-SCVMHost $VMHost -BMCRunAsAccount $BMCRAA
PS C:\> Read-SCVMHost -VMHost $VMHost -RefreshOutOfBandProperties

第一個命令會取得名為 VMHost02 的主機物件,並將物件儲存在$VMHost變數中。

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

第三個命令會使用儲存在 $BMCRAA 的新執行身分帳戶來更新儲存在 $VMHost 中的主機。

最後一個命令會使用其頻外介面重新整理儲存在 $VMHost 中的主機,這會更新主機的執行身分帳戶。

範例 6:更新叢集中 XenServer 主機的憑證

PS C:\> $VMHost = Get-VMHost -ComputerName "XenHost01" 
PS C:\> $Cert = Get-SCCertificate -Computername $VMHost.Name 
PS C:\> Set-SCVMHost -VMHost $VMHost -Certificate $Cert -EnableSecureMode $True

第一個命令會取得名為 XenHost01 的主機物件,並將物件儲存在$VMhost變數中。

第二個會取得 XenHost01 的憑證物件,並將物件儲存在$Certificate變數中。

最後一個命令會使用$Cert中提供的憑證,讓 VMM 以安全模式與 XenHost01 通訊。

參數

-ApplyLatestCodeIntegrityPolicy

指出此 Cmdlet 會使主機使用 CodeIntegrityPolicyPath中儲存的檔案位置來更新其 HVCI 原則。

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

-AttestationServerUrl

指定證明伺服器的 URL。

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

-AvailableForPlacement

指出 VMM 放置程式會將此主機或主機上的此磁片區視為部署虛擬機器的可能位置。 如果此參數設定為 $False,您可以選擇在此主機或磁片區上部署虛擬機器。 預設值為 $True。 此參數不適用於 VMware ESX 主機。

當您將此參數與網路介面卡搭配使用時,如果設定為 $False,則放置不會考慮在此網路介面卡上設定的邏輯網路,以判斷主機是否適合連線虛擬機器。

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

-BaseDiskPaths

指定基底磁片的路徑。

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

-BMCAddress

指定或更新特定實體電腦的頻外基礎板管理控制器 (BMC) 位址。 這可能是 IP 位址、FQDN) (完整功能變數名稱,或 DNS 前置詞 (,這通常與 NetBIOS 名稱) 的名稱相同。

一般而言,BMC 位址及其與網路連線會與標準網路介面卡相關聯的 IP 位址分開。 或者,有些電腦會使用標準網路介面卡來提供 BMC 和網路介面卡的單一位址。 不過,BMC 位址具有唯一的埠,因此可在網路上唯一識別。

  • 範例 IPv4 格式: -BMCAddress "10.0.0.21"
  • 範例 Ipv6 格式: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • 範例 FQDN 格式: -BMCAddress "Computer01.Contoso.com"
  • NetBIOS 格式範例: -BMCAddress "Computer01"

注意:根據預設,VMM 會針對 BMCAddress使用 IP 位址或 FQDN。 不過,您也可以建立Windows PowerShell模組,讓您將其他類型的位址指定為 BMC 位址。

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

-BMCCustomConfigurationProvider

指定或更新 BMC) 基礎板管理控制器的組態提供者物件 (。 組態提供者是 VMM 的外掛程式,可將 VMM PowerShell 命令轉譯為 BMC 類型特定的 API 呼叫。 將此參數與自訂 BMCProtocol搭配使用。

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

-BMCPort

指定或更新特定實體電腦的頻外基礎板管理控制器 (BMC) 埠。 BMC 埠也稱為服務處理器埠。 IPMI 的預設埠範例為 623,而透過 WS-Man 的 SMASH 則為 443。

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

-BMCProtocol

指定或更新 VMM 用來與頻外基礎板管理控制器通訊的通訊協定, (BMC) 。 有效值為:

  • IPMI
  • 粉碎
  • Custom

BMC (也稱為服務處理器或管理控制器) 是伺服器主機板上的特製化控制器,可作用硬體與系統管理軟體之間的介面。 如果實體機器的主機板包含 BMC,當機器插入電源 (是否已關閉或開啟電源,以及是否已安裝作業系統) 、系統硬體的相關資訊以及該系統硬體健康情況的狀態可用時。

範例格式: -BMCProtocol "Custom"

注意:自訂通訊協定要求您使用 BMCCustomConfigurationProvider 參數。

Type:OutOfBandManagementType
Accepted values:None, IPMI, SMASH, Custom
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BMCRunAsAccount

指定要與 BMC) 裝置 (基礎板管理控制器搭配使用的執行身分帳戶。

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

-BypassMaintenanceModeCheck

表示即使主機不在維護模式中,程式碼完整性原則仍會套用至主機。 根據預設,如果主機不在維護模式中,套用程式碼完整性原則就會失敗。

Type:SwitchParameter
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

-CPUPercentageReserve

指定要在實體主機電腦上使用作業系統的 CPU 百分比。 如果您未使用此參數來指定保留,則會使用主機群組的預設設定:10%。 VMM 放置程式不建議將虛擬機器放在主機上,除非可以符合其資源需求,而不需要使用主機保留。

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

-Custom1

指定虛擬機器主機上的自訂屬性。

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

-Custom10

指定虛擬機器主機上的自訂屬性。

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

-Custom2

指定虛擬機器主機上的自訂屬性。

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

-Custom3

指定虛擬機器主機上的自訂屬性。

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

-Custom4

指定虛擬機器主機上的自訂屬性。

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

-Custom5

指定虛擬機器主機上的自訂屬性。

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

-Custom6

指定虛擬機器主機上的自訂屬性。

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

-Custom7

指定虛擬機器主機上的自訂屬性。

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

-Custom8

指定虛擬機器主機上的自訂屬性。

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

-Custom9

指定虛擬機器主機上的自訂屬性。

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

-Description

指定 Host 物件的描述。

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

-DiskSpaceReserveMB

指定要在實體主機電腦上使用作業系統的磁碟空間量,以 MB 為單位 (MB) 。 如果您未使用此參數來指定保留,則會針對主機群組使用預設設定 100 MB。 VMM 放置程式不建議將虛擬機器放在主機上,除非可以符合其資源需求,而不需要使用主機保留。

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

-EnableLiveMigration

指出主機上是否啟用即時移轉。

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

-FibreChannelWorldWideNodeName

指定光纖通道全球節點名稱。

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

-FibreChannelWorldWidePortNameMaximum

指定光纖通道全球埠名稱範圍的最大值。

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

-FibreChannelWorldWidePortNameMinimum

指定光纖通道全球埠名稱範圍的最小值。

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

-IsDedicatedToNetworkVirtualizationGateway

指出主機是否專用於網路虛擬化閘道。

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

-KeyProtectionServerUrl

指定金鑰保護伺服器的 URL (KPS) 。

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

-LiveMigrationMaximum

指定同時即時移轉的最大數目。

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

-LiveStorageMigrationMaximum

指定同時即時儲存體移轉的最大數目。

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

-MaintenanceHost

此參數已經過時。 請改用 AvailableForPlacement

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

-ManagementAdapterMACAddress

指定 VMM 伺服器用來與此主機通訊之電腦上的實體網路介面卡 MAC 位址。

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

-MaxDiskIOReservation

指定實體主機電腦上的每秒磁片 I/O 上限 (IOPS) 。 如果您未使用此參數來指定保留,則會針對主機群組使用預設設定 10000。 VMM 放置程式不建議將虛擬機器放在主機上,除非可以符合其資源需求,而不需要使用主機保留。

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

-MemoryReserveMB

指定要在實體主機電腦上使用主機作業系統的記憶體數量,以 MB 為單位 (MB) 。 如果您未使用此參數來指定保留,則會針對主機群組使用預設設定 256 MB。 VMM 放置程式不建議將虛擬機器放在主機上,除非可以符合其資源需求,而不需要使用主機保留。

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

-MigrationAuthProtocol

指定用於移轉的授權通訊協定。 此參數可接受的值為:CredSSP、Kerberos。

Type:MigrationAuthProtocolType
Accepted values:CredSSP, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MigrationPerformanceOption

指定移轉效能選項類型。 此參數可接受的值為:

  • 標準
  • UseCompression
  • UseSmbTransport
Type:MigrationPerformanceOptionType
Accepted values:Standard, UseCompression, UseSmbTransport
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MigrationSubnet

指定要用於移轉的子網陣列。

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

-NetworkPercentageReserve

指定要在實體主機電腦上使用主機作業系統的網路容量百分比。 如果您未使用此參數來指定保留,則會針對主機群組使用預設設定 10%。 VMM 放置程式不建議將虛擬機器放在主機上,除非可以符合其資源需求,而不需要使用主機保留。

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

-NumaSpanningEnabled

指出是否啟用 NUMA 跨越。

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

-OverrideHostGroupReserves

表示當設定為 $True 時,提供的設定會覆寫來自父主機群組的主機保留設定。

Type:Boolean
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

-RemoteConnectCertificatePath

此參數已經過時。

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

-RemoteConnectEnabled

啟用當設定為 $True 時,主機伺服器上的連線可讓使用者從遠端連線到其虛擬機器。 此參數僅適用于 Hyper-V 主機上的虛擬機器。 不適用於 VMware ESX 主機或 Citrix XenServer 主機上的虛擬機器。

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

-RemoteConnectPort

指定遠端使用者連線至虛擬機器時所用的 TCP 通訊埠預設值。 一般而言,Hyper-V 主機的預設埠是 2179。 此參數不適用於 VMware ESX 主機或 Citrix XenServer 主機。

Type:UInt32
Aliases:VMRCPort
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRemoteConnectCertificate

此參數已經過時。

Type:SwitchParameter
Aliases:RemoveVMRCCertificate
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

-SecureRemoteConnectEnabled

此參數已經過時。

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

-SMBiosGuid

針對與 VMM 中該實體電腦之記錄相關聯的實體電腦,指定 SMBIOS GUID (SMBIOS GUID) 系統管理 BIOS 全域唯一識別碼。 SMBIOS 會定義資料結構和存取方法,讓使用者或應用程式能夠儲存及擷取這部電腦上硬體的相關資訊,例如系統名稱、製造商或系統 BIOS 版本。 Windows 作業系統會在系統啟動時擷取 SMBIOS 資料,並將該資料提供給程式使用。

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

-UseAnyMigrationSubnet

指出是否可以使用任何子網進行移轉。

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

-VMHost

指定虛擬機器主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。

如需每種主機類型的詳細資訊,請參閱 Add-SCVMHost Cmdlet。

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

-VMHostManagementCredential

此參數已經過時。

Type:VMMCredential
Aliases:PerimeterNetworkHostCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

輸出

Host

此 Cmdlet 會傳回 Host 物件。