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-SCVirtual DHCPDrive、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
指定檢查點類型。 此參數可接受的值為：
- 已停用
- 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 |
-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 秘訣。
| 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