Set-SCVMConfiguration
修改計算機層的虛擬機組態。
語法
Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
[-CapabilityProfile <CapabilityProfile>]
[-VMMServer <ServerConnection>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
-VMHost <Host>
[-PinVMHost <Boolean>]
[-CapabilityProfile <CapabilityProfile>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
[-VMHostGroup <HostGroup>]
[-CapabilityProfile <CapabilityProfile>]
[-VMMServer <ServerConnection>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Set-SCVMConfiguration
[-VMLocation <String>]
[-PinVMLocation <Boolean>]
[-ComputerName <String>]
[-PinVMHost <Boolean>]
-Cloud <Cloud>
[-CapabilityProfile <CapabilityProfile>]
[-VMConfiguration] <BaseVMConfiguration>
[-Description <String>]
[-Tag <String>]
[-CostCenter <String>]
[-Name <String>]
[-NoConnectedHost]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
Set-SCVMConfiguration Cmdlet 會修改電腦層的虛擬機組態。 虛擬機組態描述部署服務時虛擬機的設定方式。
範例
範例 1：在部署服務之前更新機器層的虛擬機設定
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"第一個命令會取得名為 Service01 的服務組態物件，並將物件儲存在$ServiceConfig變數中。
第二個命令會取得儲存在 $ServiceConfig 之服務組態的計算機層組態，並將物件儲存在 $TierConfig 變數中。
第三個命令會取得儲存在 $TierConfig 之計算機層組態的虛擬機組態，並將變數儲存在 $VMConfig 變數中。
最後一個命令會設定儲存在 $VMConfig 中之第一個虛擬機組態物件的 description 屬性，並將虛擬機組態的屬性顯示給使用者。
範例 2：設定機器層的虛擬機組態物件，以釘選虛擬機的主機
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True第一個命令會取得名為 Service01 的服務組態物件，並將物件儲存在$ServiceConfig變數中。
第二個命令會取得儲存在 $ServiceConfig 之服務組態的計算機層組態物件，並將物件儲存在$TierConfig變數中。
第三個命令會取得儲存在 $TierConfig 之計算機層組態的虛擬機組態物件，並將物件儲存在 $VMConfig 變數中。
最後一個命令會將 pinVMHost propety 設定為$True儲存在 $VMConfig 中的第一個虛擬機組態物件。 因此，部署服務時，將不會變更使用此組態建立之虛擬機的主機。
範例 3：為私人雲端中的服務設定虛擬機組態物件
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"第一個命令會取得名為 Service01 的服務組態物件，並將物件儲存在$ServiceConfig變數中。
第二個命令會取得儲存在 $ServiceConfig 之服務組態的計算機層組態，並將物件儲存在 $TierConfig 變數中。
第三個命令會取得儲存在 $TierConfig 之計算機層組態的虛擬機組態物件，並將物件儲存在 $VMConfig 變數中。
第四個命令會取得名為 Production 的私人雲端物件，並將物件儲存在 $Cloud 變數中。
最後一個命令會針對儲存在 $Cloud 中私人雲端，更新儲存在 $VMConfig 中的第二個虛擬機組態物件的描述。
參數
-AvailabilitySetNames
指定可用性設定組名稱的清單。
| 類型: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CapabilityProfile
指定功能設定檔物件。
| 類型: | CapabilityProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Cloud
指定私人雲端物件。
| 類型: | Cloud |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ComputerName
指定 Virtual Machine Manager （VMM） 可在網路上唯一識別的電腦名稱。 有效格式如下：
- FQDN
- IPv4 或 IPv6 位址
- NetBIOS 名稱
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CostCenter
指定虛擬機的成本中心，以便收集虛擬機配置的相關數據（或配置給虛擬機的資源），以在計費系統中使用。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
指定組態的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 VMM 物件的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-NoConnectedHost
從虛擬機組態中移除主機。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUser
指定用戶的名稱。 這個 Cmdlet 會將代表用戶設定為此參數所指定的使用者。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnBehalfOfUserRole
指定使用者角色。 此 Cmdlet 會將代表使用者角色設定為此參數所指定的使用者角色。 若要取得使用者角色物件，請使用 Get-SCUserRole Cmdlet。
| 類型: | UserRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PinVMHost
指出使用者選擇的虛擬機主機是否在服務部署設定期間保留。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PinVMLocation
指出使用者選擇的虛擬機位置是否在服務部署設定期間保留。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行，讓控件立即返回命令殼層。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Tag
指定要與 物件建立關聯的單字或片語，以便搜尋具有指定標記集的所有物件。 您可以搜尋標記的子集，也可以搜尋完整的標記集。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMConfiguration
指定虛擬機組態物件。
| 類型: | BaseVMConfiguration |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VMHost
指定虛擬機主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。
如需每種主機類型的詳細資訊，請參閱 Add-SCVMHost Cmdlet。
| 類型: | Host |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMHostGroup
指定虛擬機主機群組物件或主機群組物件的陣列。
| 類型: | HostGroup |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMLocation
指定虛擬機的路徑。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
| 類型: | ServerConnection |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸出
VMConfiguration
此 Cmdlet 會傳回 VMConfiguration 物件。