Set-SCVMConfiguration

模組:

VirtualMachineManager

修改電腦層的虛擬機器組態。

Syntax

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

指定可用性設定組名稱的清單。

Type:	System.Collections.Generic.List`1[System.String]
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

-Cloud

指定私人雲端物件。

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

-ComputerName

指定 Virtual Machine Manager (VMM) 可在網路上唯一識別的電腦名稱稱。 有效格式為：

• FQDN
• IPv4 或 IPv6 位址
• NetBIOS 名稱

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

-Description

指定組態的描述。

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

-Name

指定 VMM 物件的名稱。

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

-NoConnectedHost

從虛擬機器組態中移除主機。

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

指定使用者角色。 此 Cmdlet 會將 代表使用者角色設定為此參數指定的使用者角色。 若要取得使用者角色物件，請使用 Get-SCUserRole Cmdlet。

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

-PinVMHost

指出使用者選擇的虛擬機器主機是否會在服務部署設定期間保留。

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

-PinVMLocation

指出使用者選擇的虛擬機器位置是否在服務部署設定期間保留。

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

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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

-VMConfiguration

指定虛擬機器組態物件。

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

-VMHost

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

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

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

-VMHostGroup

指定虛擬機器主機群組物件或主機群組物件的陣列。

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

-VMLocation

指定虛擬機器的路徑。

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

-VMMServer

指定 VMM 伺服器物件。

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

輸出

VMConfiguration

此 Cmdlet 會傳回 VMConfiguration 物件。

相關連結

• Get-SCComputerTierConfiguration
• Get-SCServiceConfiguration
• Get-SCVMConfiguration
• New-SCVMConfiguration
• Remove-SCVMConfiguration
• Update-SCVMConfiguration