Set-SCVirtualMachine
變更 VMM 所管理之虛擬機的屬性。
Syntax
Set-SCVirtualMachine
[-VM] <VM>
[-VMwareResourcePool <VmwResourcePool>]
[-StartAction <VMStartAction>]
[-StopAction <VMStopAction>]
[-RemoveSelfServiceUserRole <Boolean>]
[-EnableOperatingSystemShutdown <Boolean>]
[-EnableTimeSync <Boolean>]
[-EnableDataExchange <Boolean>]
[-EnableHeartbeat <Boolean>]
[-EnableBackup <Boolean>]
[-InstallVirtualizationGuestServices <Boolean>]
[-Owner <String>]
[-OperatingSystem <OperatingSystem>]
[-Enabled <Boolean>]
[-HighlyAvailable <Boolean>]
[-HAVMPriority <UInt32>]
[-DRProtectionRequired <Boolean>]
[-ReplicationGroup <ReplicationGroup>]
[-SecureBootEnabled <Boolean>]
[-NumLock <Boolean>]
[-CPULimitFunctionality <Boolean>]
[-CPULimitForMigration <Boolean>]
[-VMShieldingData <KeyFile>]
[-RunAsSystem]
[-RunAsUserCredential <PSCredential>]
[-DelayStartSeconds <Int32>]
[-UseHardwareAssistedVirtualization <Boolean>]
[-Cloud <Cloud>]
[-CapabilityProfile <CapabilityProfile>]
[-RemoveCapabilityProfile]
[-RemoveFromCloud]
[-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
[-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-UserRole <UserRole>]
[-Name <String>]
[-JobGroup <Guid>]
[-QuotaPoint <UInt32>]
[-CostCenter <String>]
[-Tag <String>]
[-Custom1 <String>]
[-Custom2 <String>]
[-Custom3 <String>]
[-Custom4 <String>]
[-Custom5 <String>]
[-Custom6 <String>]
[-Custom7 <String>]
[-Custom8 <String>]
[-Custom9 <String>]
[-Custom10 <String>]
[-BlockDynamicOptimization <Boolean>]
[-ClearDRProtection]
[-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>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Set-SCVirtualMachine Cmdlet 會變更 Virtual Machine Manager 所管理虛擬機的屬性， (VMM) 。
您可以變更的屬性包括下列各項：
- 將虛擬機與雲端產生關聯。
- 虛擬機的名稱、擁有者和描述。
- 如果虛擬機部署在 Hyper-V 主機上，BIOS 開機順序。
- 虛擬機所使用的主機上的資源數量。 這些選項包括：
- 虛擬機可以使用的主機 CPU 資源數量上限。
- 虛擬機預期會使用主機 CPU。
- 一部虛擬機相對於相同主機上其他虛擬機所使用的主機 CPU 資源數量。
- 虛擬機可以使用的主機記憶體數量。
- 虛擬機可以使用之主機網路上的頻寬數量。
- 與主機資源無關之虛擬機的硬體設定。 這些選項包括：
- CPU 數量。
- CPU 的類型。
- 每秒的磁碟輸入/輸出作業數目， (IOPS) 。
- 限制舊版操作系統的CPU功能，例如 Windows NT 4.0。
- 成本中心、標記和自定義設定，用來依準則篩選虛擬機。
- 啟用各種選擇性功能的設定，包括下列各項：
- 啟用或停用連結庫物件，使其可供使用者使用或暫時無法使用。
- 使用磁碟區陰影複製服務，在 Hyper-V 主機上啟用備份虛擬機。
- 啟用虛擬機與其 Hyper-V 主機之間數據交換的索引鍵/值組。
- 從 Hyper-V 控制台啟用虛擬機的關機。
- 啟用虛擬機與其 Hyper-V 主機之間的時間同步處理。
- 為 Hyper-V 主機上的虛擬機啟用 NumLock 的 BIOS 值。
- 可識別虛擬機是否為高可用性的設定，也就是要在 Hyper-V 主機叢集或 Citrix XenServer 主機叢集節點上部署的虛擬機。
- 設定，判斷虛擬化客體服務是否安裝在部署在 Hyper-V 主機上的虛擬機上。
- 啟動虛擬機之前延遲的秒數。
- 識別用於虛擬機之作業系統的設定。
- 啟動和停止虛擬機的動作。
- 設定會限制虛擬機自助使用者可以建立的數目。
- 用來切換屬於多個角色的自助用戶用來管理虛擬機的角色設定。
- 將ESX主機上的虛擬機指派給VMware資源集區的設定。
如果您想要變更與特定虛擬機相關聯的虛擬磁碟驅動器、虛擬 DVD 磁碟驅動器、虛擬網路適配器或虛擬 SCSI 適配卡的屬性，請使用 Set-SCVirtualFloppyDrive、Set-SCVirtualVPDrive、Set-SCVirtualNetworkAdapter 或 Set-SCVirtualScsiAdapter Cmdlet。
範例
範例 1：指定現有虛擬機的記憶體數量
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024第一個命令會取得名為 VM01 的虛擬機對象，然後將該物件儲存在$VM變數中。
第二個會決定儲存在$VM中的虛擬機是否處於關閉電源狀態。
如果虛擬機未處於關閉電源狀態，命令會使用 Stop-SCVirtualMachine 命令來關閉虛擬機的電源。
如需關閉虛擬機器電源的詳細資訊，請輸入 Get-Help Stop-SCVirtualMachine。
最後一個命令會將配置給 VM01 的記憶體變更為 1024 MB。
範例 2：變更使用者角色，以管理屬於多個自助使用者角色的用戶虛擬機
PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole第一個命令會從 VMMServer01 取得名為 VM02 的虛擬機物件，然後將該物件儲存在$VM變數中。
第二個命令會取得名為 ContosoSelfServiceUsers 的使用者角色對象，然後將物件儲存在$SSRole變數中。
最後一個命令會指定名為 SSUserRole3 的自助式使用者角色成員現在已獲得管理 VM02 之虛擬機的許可權。
注意：VMM 會使用 UserRole 參數來設定特定自助使用者角色的成員所管理的虛擬機。 一般而言，您不需要搭配UserRole參數使用Set-SCVirtualMachine Cmdlet 來設定此設定。 不過，如果一或多個使用者是多個自助使用者角色的成員，而且您授與他們管理相同主機上多個虛擬機的許可權，您可能會遇到想要切換哪些使用者角色有權管理特定虛擬機的情況。 這個範例說明此案例。
範例 3：停用做為域控制器之虛擬機上的時間同步處理
PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP第一個命令會將目前的 $ErrorActionPreference 設定存放至變數 $EAP。 此變數稍後會用來將設定傳回至其原始值。
第二個命令會將動作喜好設定設定為「停止」。 這個錯誤動作喜好設定會將錯誤從非終止錯誤變更為終止錯誤。 錯誤物件會引發為例外狀況，而不是寫入輸出管道，而且命令不會繼續執行。
第三個命令會取得名為 VM03 的虛擬機物件，並將該物件儲存在$VM變數中。
第四個命令會停用時間同步處理設定。 一般而言，當做域控制器的虛擬機需要停用時間同步處理。 此命令會使用 trap 語句來攔截終止例外狀況。 如果 Set-SCVirtualMachine 命令失敗，就會顯示 陷阱 語句中的字串。 在 trap 語句中使用 Continue，以繼續執行，而不是結束。 Out-Null 指令程式會將輸出重新導向至 $Null，而不會將輸出傳送至主控台。
最後一個命令會將 $ErrorActionPreference 的值設定為 $EAP 中存放的值。
範例 4：針對支援此功能的所有虛擬機設定裝置啟動順序
PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP第一個命令會將目前的 $ErrorActionPreference 設定存放至 $EAP。 此變數稍後會用來將設定傳回至其原始值。
第二個命令會將錯誤動作喜好設定設為 Stop。 這個錯誤動作喜好設定會將錯誤從非終止錯誤變更為終止錯誤。 錯誤物件會引發為例外狀況，而不是寫入輸出管道，而且命令不會繼續執行。
第三個命令會取得每個虛擬機物件將物件儲存在$VMs中。 使用 @ 符號和括號可確保命令會將結果儲存在陣列中，以防命令傳回單一物件或 Null 值。
第四個命令會將每個虛擬機的BIOS開機順序設定為PXEBoot，IDEHarddrive，CD，Floppy。 此命令會使用陷阱語句來攔截終止例外狀況。 如果 Set-SCVirtualMachine 命令失敗，就會顯示陷阱語句中的字串。 在陷阱語句中使用 Continue 來繼續執行，而不是結束 ForEach 迴圈。 Out-Null Cmdlet 會將輸出重新導向至$Null，而不是將它傳送至控制台。
注意： BootOrder 參數僅適用於 Hyper-V 和 Citrix XenServer 主機上的虛擬機。 它不適用於 VMware ESX 主機上的虛擬機。 XenServer 主機不支援磁碟驅動器，因此如果開機順序所列，則會忽略 Floppy。
最後一個命令會將 $ErrorActionPreference 的值設定為 EAP 中存放的值。
如需標準 Windows PowerShell ForEach 循環語句的詳細資訊，請輸入 Get-Help about_ForEach。
範例 5：針對沒有擁有者的所有虛擬機指定擁有者
PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq ""} | Set-SCVirtualMachine -Owner "Contoso\ReneeLo"此命令會取得 VMMServer01 上的所有虛擬機物件、只選取未列出任何擁有者的虛擬機物件，並指定每個虛擬機的擁有者。
範例 6：為現有的虛擬機啟用動態記憶體
PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048第一個命令會取得虛擬機物件 VM06，並將該物件儲存在 $VM 變數中。 若要在虛擬機上啟用動態記憶體，虛擬機必須位於執行 Windows Server 2008 R2 SP1 或更新版本的主機上。
第二個命令會判斷儲存在 $VM 中的虛擬機是否處於關閉電源狀態。 如果虛擬機未處於關閉電源狀態，此命令會使用 Stop-SCVirtualMachine 命令來關閉虛擬機的電源。
最後一個命令會啟用動態記憶體、將啟動記憶體設定為 1024 MB，並將記憶體上限設定為 2048 MB。 啟動記憶體是啟動時配置給 VM06 之主機上的記憶體數量。 最大記憶體是配置給 VM06 的主機上記憶體數量上限。
參數
-AutomaticCriticalErrorAction
指定虛擬機遇到重大錯誤時要採取的動作，並超過 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 |
-AvailabilitySetNames
指定可用性設定組名稱的清單。
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlockDynamicOptimization
指出虛擬機是否封鎖動態優化。
| Type: | Boolean |
| Aliases: | ExcludeFromPRO |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootOrder
指定 Hyper-V 主機上虛擬機用來啟動之裝置的順序，做為數位。 有效值為：
- CD
- IDEHardDrive
- PXEBoot
- 磁碟機
| 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
指定檢查點類型。 此參數可接受的值為：
- 已停用
- 生產
- ProductionOnly
- 標準
| Type: | CheckpointType |
| Accepted values: | Disabled, Production, ProductionOnly, Standard |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearDRProtection
指出此 Cmdlet 會重設數據保護選項。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Cloud
指定私人雲端物件。
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterNonPossibleOwner
指定指定虛擬機之非可能叢集節點擁有者的名稱清單。
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClusterPreferredOwner
指定特定虛擬機慣用叢集節點擁有者的名稱清單。
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CostCenter
指定虛擬機的成本中心。 您可以收集針對計費系統配置虛擬機或資源配置的相關數據。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUCount
指定虛擬機上的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
指出是否要為虛擬機提供有限的CPU功能。 指定 $True 的值，以支援部署在 Hyper-V 主機或 VMware ESX 主機上的虛擬機上，例如 Windows NT 4.0 等舊版作業系統。
| Type: | Boolean |
| Aliases: | LimitCPUFunctionality |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUMaximumPercent
指定虛擬機可以同時使用的主機上單一 CPU 的總資源百分比上限。
| 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。 高。 2000.
- VMware ESX。 高於標準。 1500.
- VMware ESX。 一般 (預設) 。 1000。
- VMware ESX。 在 [一般] 下方。 750.
- VMware ESX。 低。 500.
- 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 Cmdlet。
| Type: | ProcessorType |
| 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 |
-DelayStartSeconds
指定啟動虛擬化服務之後，以及自動啟動虛擬機器之前，所要等待的秒數。
此延遲會使多部虛擬機的啟動時間過時，以協助減少實體計算機資源的需求。 一般設定可能是 30 到 60 秒。 主機的可設定延遲上限如下：
- Hyper-V。 1000000000 秒 (277777 小時)
- VMware ESX。 65535 秒 (18 小時)
此參數不適用於 XenServer 虛擬機。
| Type: | Int32 |
| Aliases: | DelayStart |
| 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) 。
| 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。
| 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 或更新版本的主機。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicMemoryMaximumMB
如果已啟用易失記憶體，則指定主機可以配置給虛擬機的最大記憶體數量。 預設值為 65536。
只有當該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或虛擬機儲存在處於停止狀態的連結庫中時，才能啟用虛擬機的易失記憶體。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicMemoryMinimumMB
指定如果已啟用易失記憶體，主機可以配置給虛擬機的最小記憶體數量。 預設值為 65536。
只有當該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或虛擬機儲存在處於停止狀態的連結庫中時，才能啟用虛擬機的易失記憶體。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBackup
指出此 Cmdlet 是否可讓磁碟區陰影複製服務備份虛擬機。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enabled
指出此 Cmdlet 是否啟用或停用虛擬機。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDataExchange
指出此 Cmdlet 是否啟用或停用在虛擬機與主機作業系統之間交換數據的索引鍵/值組。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableHeartbeat
指出此 Cmdlet 是否啟用或停用活動訊號來監視虛擬機的健康情況。 活動訊號是在設定間隔發出的訊號。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableNestedVirtualization
啟用巢狀虛擬化。
注意
此參數適用於 VMM 2019 UR1 和更新版本。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableOperatingSystemShutdown
指出此 Cmdlet 是否啟用或停用從主機上 Hyper-V 管理介面管理之虛擬機上的操作系統關閉。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableTimeSync
指出此 Cmdlet 是否啟用或停用同步處理虛擬機的系統時間，以及主機上執行之作業系統的系統時間。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Aliases: | EnableTimeSynchronization |
| 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 |
-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 |
-InstallVirtualizationGuestServices
指出此 Cmdlet 是否在以 Windows 為基礎的虛擬機上安裝虛擬化客體服務。 默認值為 $False，VMM 會自動安裝適當的虛擬化客體服務。
對於 Hyper-V 主機上的虛擬機，虛擬化客體服務稱為整合元件或VMGuest.iso。 對於 XenServer 主機上的虛擬機，虛擬化客體服務稱為 Citrix Tools for 虛擬機器 或 xs-tools.iso。 VMware ESX 主機上的虛擬機器不會使用虛擬化來賓服務。
| 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
指定配置給虛擬機的主機上，以 MB (MB) 為單位的 RAM) (RAM (隨機存取記憶體數量。 預設值是 512 MB。 針對啟用易失記憶體的虛擬機，指定啟動記憶體值。 可指派主機記憶體上限如下：
- 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 或更新版本的主機，預設值如下：
- 低。 0
- 一般。 5000
- 高。 10,000
- 自訂： 10,000
| 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。
| Type: | String |
| Aliases: | MonitorResolutionMaximum |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定虛擬機器的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkUtilizationMbps
指定虛擬機可以使用的主機網路上，每秒 mbbits (Mbps) 的頻寬量。
| 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
指出此 Cmdlet 是否啟用或停用虛擬機上 NumLock 的 BIOS 值。 虛擬機必須部署在 Hyper-V 主機上。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定使用者名稱。 這個 Cmdlet 會代表此參數所指定的用戶運作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 會代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystem
指定虛擬機器的作業系統類型。 若要列出 VMM 中所有可用作業系統的名稱，請使用 Get-SCOperatingSystem Cmdlet。
| Type: | OperatingSystem |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Owner
將虛擬機的擁有者指定為有效的網域用戶帳戶。
| 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 提示的標識碼) 。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QuotaPoint
指定限制虛擬機自助使用者可以部署的配額。
| Type: | UInt32 |
| 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
指出這個 Cmdlet 會移除一或多個指定的功能配置檔物件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveFromCloud
指出此 Cmdlet 會移除虛擬機與雲端之間的關聯。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveSelfServiceUserRole
指出此 Cmdlet 是否會從虛擬機的許可權清單中移除指定的自助使用者角色。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicationGroup
指定複寫群組。
| Type: | ReplicationGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsSystem
表示虛擬機是在本機系統帳戶下執行。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsUserCredential
指定虛擬機執行所在的客體帳戶。
若要增強安全性，請建立具有有限許可權的特殊帳戶。 最低許可權如下所示：
- .vmc 檔案。 讀取數據、寫入數據、執行檔案
- .vmc資料夾。 列出資料夾、寫入/建立檔案以儲存虛擬機狀態
- .vhd 檔案。 讀取數據、讀取屬性、讀取擴充屬性、寫入數據
- .vnc 檔案。 執行檔案、讀取數據、讀取屬性、如果虛擬機連線到虛擬網路，則讀取
此參數不適用於 Hyper-V、VMware ESX 或 Citrix XenServer 主機的虛擬機。
| Type: | PSCredential |
| 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
指出此 Cmdlet 是否啟用安全啟動。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecureBootTemplate
指定要用於第 2 代虛擬機的安全開機範本。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartAction
指定虛擬機在虛擬化服務啟動時的行為。 有效值為：
- AlwaysAutoTurnOnVM
- NeverAutoTurnOnVM
- TurnOnVMIfRunningWhenVSStopped
| Type: | VMStartAction |
| Accepted values: | NeverAutoTurnOnVM, AlwaysAutoTurnOnVM, TurnOnVMIfRunningWhenVSStopped |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StopAction
指定虛擬化服務停止時虛擬機的行為。 有效值為：
- SaveVM
- TurnOffVM
- ShutdownGuestOS
| Type: | VMStopAction |
| Accepted values: | SaveVM, TurnOffVM, ShutdownGuestOS |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
指定要與虛擬機建立關聯的單字或片語。 您可以搜尋具有指定標籤的所有物件。 您可以搜尋卷標子集，也可以搜尋完整的卷標集。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseHardwareAssistedVirtualization
指出是否可以使用硬體輔助虛擬化。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
指定使用者角色物件。
| Type: | UserRole |
| Aliases: | SelfServiceUserRole |
| 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 的主機，或已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務的主機。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定虛擬機器物件。
| Type: | VM |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMShieldingData
指定 VMShieldingData 物件。
| Type: | KeyFile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMwareResourcePool
指定 VMware 資源集區。 此 Cmdlet 會將部署在 VMware ESX 主機或私人雲端上的虛擬機指派給此參數所指定的資源集區。
| Type: | VmwResourcePool |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸出
VirtualMachine
此 Cmdlet 會傳回 VirtualMachine 物件。
備註
- 此 Cmdlet 需要 VMM 虛擬機物件，可以使用 Get-SCVirtualMachine Cmdlet 來擷取。
相關連結
- Get-SCCPUType
- Get-SCUserRole
- Move-SCVirtualMachine
- New-SCVirtualMachine
- Read-SCVirtualMachine
- Remove-SCVirtualMachine
- Repair-SCVirtualMachine
- Resume-SCVirtualMachine
- Save-SCVirtualMachine
- Set-SCVirtualDVDDrive
- Set-SCVirtualFloppyDrive
- Set-SCVirtualNetworkAdapter
- Set-SCVirtualScsiAdapter
- Start-SCVirtualMachine
- Stop-SCVirtualMachine
- Suspend-SCVirtualMachine