共用方式為


Set-SCHardwareProfile

變更 VMM 中使用的硬體設定檔案屬性。

Syntax

Set-SCHardwareProfile
   [-HardwareProfile] <HardwareProfile>
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-Name <String>]
   [-RemoveCapabilityProfile]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-JobGroup <Guid>]
   [-CapabilityProfile <CapabilityProfile>]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCHardwareProfile Cmdlet 會變更 Virtual Machine Manager (VMM) 環境中所使用的硬體設定檔物件的一或多個屬性。 可以變更的內容包括下列設定:開機順序、CPU 設定、主機上指派給虛擬機器的記憶體數量以及其他選項。

若要變更與特定硬體設定檔相關聯的虛擬磁片磁碟機、虛擬 DVD 磁片磁碟機、虛擬 COM 埠、虛擬網路介面卡或虛擬 SCSI 介面卡的屬性,請分別使用Set-SCVirtualFloppyDrive、Set-SCVirtual DHCPDriveSet-SCVirtualCOMPortSet-SCVirtualNetworkAdapterSet-SCVirtualScsiAdapter Cmdlet。

對硬體設定檔進行的變更只會影響硬體設定檔本身。 這些變更不會影響使用此設定檔建立的任何現有虛擬機器。

範例

範例 1:指定現有硬體設定檔的記憶體數量

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Set-SCHardwareProfile -HardwareProfile $HWProfile -MemoryMB 1024

第一個命令會取得名為 NewHWProfile01 的硬體設定檔物件,並將物件儲存在$HWProfile變數中。

第二個命令會將 NewHWProfile01 的記憶體值變更為 1024 MB。

範例 2:為多個硬體設定檔指定新的擁有者

PS C:\> $HWProfiles = Get-SCHardwareProfile | where {$_.Name -match "Profile"}
PS C:\> ForEach ($HWProfile in $HWProfiles) {Set-SCHardwareProfile -HardwareProfile $HWProfile -Owner "Contoso\Cesar"}

第一個命令會取得符合搜尋準則的硬體設定檔物件,並將物件儲存在$HWProfiles物件陣列中。

第二個命令會使用 ForEach 語句,為數組中的每個設定檔指定新的擁有者。

如需標準 PowerShell ForEach 迴圈語句的詳細資訊,請輸入 Get-Help about_ForEach

範例 3:為多個硬體設定檔指定新的開機順序

PS C:\> $HWProfiles = @(Get-SCHardwareProfile | where {$_.Name -match "HWProfile"})
PS C:\> ForEach ($HWProfile in $HWProfiles) {Set-SCHardwareProfile -HardwareProfile $HWProfile -BootOrder PXEBoot,CD,IDEHardDrive,Floppy}

第一個命令會取得程式庫符合搜尋準則的所有硬體設定檔物件, (設定檔名稱包含字串 「HWProfile」) ,並將硬體設定檔物件儲存在$HWProfiles物件陣列中。 使用 @ 符號和括弧可確保命令會將結果儲存在陣列中,以防命令傳回單一物件或$Null值。

第二個命令會使用 ForEach 語句,為$HWProfiles陣列中的每個硬體設定檔物件指定新的開機順序。

範例 4:搜尋具有特定設定的硬體設定檔,並將文字附加至描述欄位

PS C:\> $HWProfiles = @(Get-SCHardwareProfile | where {$_.CPUCount -eq 4})
PS C:\> ForEach ($HWProfile in $HWProfiles) {$Text = $HWProfile.Description; Set-SCHardwareProfile -HardwareProfile $HWProfile -Description $Text" (Contains four Processors)"}

第一個命令會取得符合搜尋準則的所有硬體設定檔物件, (CPU 計數等於 4) ,並將硬體設定檔物件儲存在$HWProfiles物件陣列中。

第二個命令會使用 ForEach 語句逐一查看$HWProfiles陣列中的每個設定檔物件。 針對每個設定檔,描述文字會儲存至變數 ($Text) ,然後 Set-SCHardwareProfile Cmdlet 會使用 Description 參數將 「 (Contains four Processors) 」 附加至每個$Text實例的內容。

範例 5:為現有的硬體設定檔啟用動態記憶體

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile05" }
PS C:\> Set-SCHardwareProfile -HardwareProfile $HWProfile -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

第一個命令會取得名為 NewProfile5 的硬體設定檔物件,並將物件儲存在$HWProfile變數中。

第二個命令會啟用 NewHWProfile05 的動態記憶體、將啟動記憶體值變更為 1024 MB,並將最大記憶體值設定為 2048 MB。

參數

-AutomaticCriticalErrorAction

指定 VM 遇到重大錯誤時所要採取的動作,並超過 AutomaticCriticalErrorActionTimeout 參數所指定的逾時持續時間。 此參數可接受的值為:Pause 和 None。

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

-AutomaticCriticalErrorActionTimeout

指定在關閉虛擬機器電源之前,等待重大暫停的時間量,以分鐘為單位。

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

-BootOrder

指定 Hyper-V 主機上虛擬機器用來啟動之裝置的順序,做為陣列。 有效值為:

  • CD
  • IDEHardDrive
  • PXEBoot
  • 磁碟機

範例格式: -BootOrder PXEBoot,IDEHardDrive,CD,Floppy

Type:BootDevice[]
Accepted values:Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

指定功能設定檔物件。

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

-CheckpointType

指定檢查點類型。 此參數可接受的值為:

  • 已停用
  • Production
  • ProductionOnly
  • 標準
Type:CheckpointType
Accepted values:Disabled, Production, ProductionOnly, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CPUCount

在虛擬機器、硬體設定檔或範本上指定 CPU 數目。

主機類型支援下列 CPU 數目:

  • Hyper-V。 每個虛擬機器最多四個 CPU,視客體作業系統而定。
  • VMware ESX。 每個虛擬機器最多四個 CPU,但在執行 Windows NT 4.0 的虛擬機器上,只有一個 CPU。
  • Citrix XenServer。 每個虛擬機器最多八個 CPU,視客體作業系統而定。
Type:Byte
Aliases:ProcessorCount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CPUExpectedUtilizationPercent

指定您預期此虛擬機器使用的主機上 CPU 百分比。 只有在 VMM 判斷虛擬機器適用的主機時,才會使用此值。

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

-CPULimitForMigration

指出是否要限制指定虛擬機器的處理器功能,以便移轉至與來源電腦不同版本的實體電腦。 如果兩部實體電腦配備不同製造商生產的處理器,VMM 便無法支援在這些電腦之間移轉虛擬機器。

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

-CPULimitFunctionality

指出是否要在部署于 Hyper-V 主機或 VMware ESX 主機上的虛擬機器上,啟用執行舊版作業系統,例如 Windows NT 4.0,方法是為虛擬機器提供有限的 CPU 功能。

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

-CPUMaximumPercent

指定在任何特定時間,特定虛擬機器可以使用主機單一 CPU 總資源的最高百分比。

範例: -CPUMaximumPercent 80 (指定百分之 80)

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

-CPUPerVirtualNumaNodeMaximum

指定每個虛擬 NUMA 節點允許的最大 CPU 數目。

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

-CPURelativeWeight

指定此虛擬機器在主機上可以使用的 CPU 資源數量,這是與相同主機上其他虛擬機器相對的數量。 具有較高權數值的虛擬機器會配置比具有較低權數值的虛擬機器配置更多的 CPU 資源。 這些值的 VMware 詞彙是共用。

主機類型支援下列相對值:

  • Hyper-V。 1 到 10000。

  • VMware ESX。 高。

  • VMware ESX。 高於標準。
  • VMware ESX。 一般 (預設) 。 1000。

  • VMware ESX。 在 [一般] 下方。

  • VMware ESX。 低。
  • VMware ESX。 自訂 1 到 1000000。

  • Citrix XenServer。 1 到 65536,一般為 256。

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

-CPUReserve

指定要配置給虛擬機器之主機上單一 CPU 資源的百分比下限。 虛擬機器可使用的 CPU 容量百分比絕不會低於這個百分比。

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

-CPUType

指定虛擬機器的 CPU 類型。 若要擷取可用於 VMM 環境中虛擬機器的所有 CPU 類型清單,請輸入 Get-SCCPUType

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

-DiskIops

指定特定虛擬機器每秒鐘可以使用的主機磁碟輸入/輸出操作 (IOPS) 數目。

範例: -DiskIO 1500 (指定 1500 IOPS)

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

-DRProtectionRequired

這個參數保留給未來使用。

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

-DynamicMemoryBufferPercentage

指定虛擬機器目前記憶體配置上方的記憶體百分比,主機應該嘗試保留為緩衝區。 預設值為 20。

範例格式: -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

指出是否要啟用虛擬機器的動態記憶體。 您可以直接在虛擬機器或在用來建立虛擬機器的範本或硬體設定檔上啟用動態記憶體。 預設值為 $False。

必要:只有在該虛擬機器部署在執行 Windows Server 2008 SP1 或更新版本的主機上,或虛擬機器儲存在程式庫中處於停止狀態,才能為虛擬機器啟用動態記憶體, (儲存虛擬機器的硬體變更,只有在虛擬機器沒有快照集) 時,才能啟用虛擬機器的動態記憶體。 在儲存在程式庫中的虛擬機器上啟用動態記憶體,會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。

範例格式: -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

指定啟用動態記憶體時可配置給虛擬機器的最大記憶體數量。 預設值為 65536。

必要:只有當該虛擬機器部署在執行 Windows Server 2008 R2 SP1 或更新版本的主機上,或虛擬機器儲存在程式庫中處於停止狀態時,才能為虛擬機器啟用動態記憶體, (儲存虛擬機器的硬體變更只有在虛擬機器沒有快照集) 時,才能啟用虛擬機器的動態記憶體。 在存放於程式庫的虛擬機器上啟用動態記憶體後,就只能將該機器放置到執行 Windows Server 2008 R2 SP1 或更新版本的主機。

範例格式: -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

指定啟用動態記憶體時可配置給虛擬機器的最小記憶體數量。 預設值為 65536。

必要:只有當該虛擬機器部署在執行 Windows Server 2008 R2 SP1 或更新版本的主機上,或虛擬機器儲存在程式庫中處於停止狀態時,才能為虛擬機器啟用動態記憶體, (儲存虛擬機器的硬體變更只有在虛擬機器沒有快照集) 時,才能啟用虛擬機器的動態記憶體。 在存放於程式庫的虛擬機器上啟用動態記憶體後,就只能將該機器放置到執行 Windows Server 2008 R2 SP1 或更新版本的主機。

範例格式: -DynamicMemoryMinimumMB 1024

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

-FirstBootDevice

指定第一次嘗試開機的裝置。

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

-HardwareProfile

指定硬體設定檔物件。

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

-HAVMPriority

指定虛擬機器優先順序。 虛擬機器依優先順序啟動,上限為主機叢集節點的限制。 此參數的有效輸入是優先順序的數值標記法:

  • 高。 3000
  • 中。 2000
  • 低。 1000

如果您指定零 (0) 的值,則虛擬機器不會自動重新開機。

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

-HighlyAvailable

指出是否要將虛擬機器放在屬於主機叢集一部分的 Hyper-V 主機上。 請在虛擬機器或用來建立虛擬機器的範本或硬體設定檔上設定此設定。

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

-MemoryMB

指定此 Cmdlet 配置給已轉換虛擬機器的主機上, (MB) RAM (RAM) 隨機存取記憶體的數量。 預設值是 512 MB。 針對在執行 Windows Server 2008 R2 SP1 或更新版本的主機上啟用動態記憶體的虛擬機器,請指定啟動記憶體值。

主機類型具有下列可指派給虛擬機器的最大記憶體:

  • Hyper-V。 每個虛擬機器最多 65536 MB RAM。
  • VMware ESX Server 3.0.x。 每個虛擬機器最多 16384 MB RAM。
  • VMware ESX Server 3.5.x。 每個虛擬機器最多 65532 MB RAM。
  • Citrix XenServer。 每個虛擬機器最多 32265 MB RAM。
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemoryPerVirtualNumaNodeMaximumMB

指定允許每個虛擬 NUMA 節點的最大記憶體數量,以 MB 為單位。

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

-MemoryWeight

指示將記憶體配置到虛擬機器的優先順序,此順序相對於相同主機上的其他虛擬機器。 設定較高之虛擬機器配置的記憶體資源,會多於設定較低的虛擬機器。

針對執行 Windows Server 2008 R2 SP1 或更新版本的主機:

  • 5000 - 一般
  • 10000 - 高
  • 0 - 低
  • 1 到 10000 - 自訂
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonitorMaximumCount

指定虛擬視訊配接器支援的監視器數目上限。

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

-MonitorMaximumResolution

指定值,以字串表示虛擬視訊配接器的最大可能監視解析度。 此參數可接受的值為:

  • 1024 x 768
  • 1280x1024
  • 1600 x 1200
  • 1920x1200

預設值為 1280x1024。

範例格式: -MonitorResolutionMaximum "1600x1200"

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

-Name

指定 VMM 物件的名稱。

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

-NetworkUtilizationMbps

指定每秒 mbps (mbps) ,特定虛擬機器可以使用的主機網路上的頻寬量。

範例格式: -NetworkUtilization 10

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

-NumaIsolationRequired

指出是否需要 NUMA 隔離。

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

-NumLock

指出是否要在用來在 Hyper-V 主機上建立虛擬機器的硬體設定檔上啟用 NumLock 的 BIOS 值。 此參數不適用於 VMware ESX 主機上或 Citrix XenServer 主機上的虛擬機器。

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

-ProtectionProvider

指定保護提供者。

Type:ProtectionProvider
Accepted values:None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
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

-RecoveryPointObjective

指定因重大事件而無法容忍從 IT 服務遺失資料的最長期間。

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

-RemoveCapabilityProfile

移除一或多個指定的功能設定檔物件。

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

-ReplicationGroup

指定 ReplicationGroup 物件。

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

-SecureBootEnabled

指出是否啟用安全開機。

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

-SecureBootTemplate

指定安全開機範本。

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

-UserRole

指定使用者角色物件。

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

-VirtualNumaNodesPerSocketMaximum

指定每個通訊端允許的 NUMA 節點數目上限。

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

-VirtualVideoAdapterEnabled

指出是否要啟用虛擬機器的 Microsoft 綜合 3D 虛擬視訊配接器。 您可以直接在虛擬機器上,或在將用來建立虛擬機器的範本或硬體設定檔上啟用虛擬視訊配接器。

必要:只有當虛擬機器部署在執行 Windows Server 2008 R2 SP1 的主機上, (已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色) 服務的虛擬機器,或是虛擬機器儲存在已停止狀態的媒體櫃中,才能啟用 Microsoft Synthetic 3D Virtual Video Adapter, (儲存虛擬機器的硬體變更只能進行如果虛擬機器沒有快照集) 則為 。 在儲存在程式庫中的虛擬機器上啟用 Microsoft 綜合 3D 虛擬視訊配接器,會將該機器的位置限制為執行 Windows Server 2008 R2 SP1 的主機, (已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務) 或更新版本。

範例格式: -VirtualVideoAdapterEnabled $True

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

輸出

HardwareProfile

此 Cmdlet 會傳回 HardwareProfile 物件。