Set-SCVMConfiguration

モジュール:

VirtualMachineManager

コンピューター層の仮想マシン構成を変更します。

構文

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>]

説明

Set-SCVMConfiguration コマンドレットは、コンピューター層の仮想マシンの構成を変更します。 仮想マシンの構成では、サービスのデプロイ時に仮想マシンを構成する方法について説明します。

例

例 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変数にオブジェクトを格納します。

2 番目のコマンドは、$ServiceConfigに格納されているサービス構成のコンピューター層の構成を取得し、$TierConfig変数にオブジェクトを格納します。

3 番目のコマンドは、$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変数にオブジェクトを格納します。

2 番目のコマンドは、$ServiceConfigに格納されているサービス構成のコンピューター層構成オブジェクトを取得し、そのオブジェクトを $TierConfig 変数に格納します。

3 番目のコマンドは、$TierConfigに格納されているコンピューター層構成の仮想マシン構成オブジェクトを取得し、$VMConfig変数にオブジェクトを格納します。

最後のコマンドは、$VMConfigに格納されている最初の仮想マシン構成オブジェクトの$Trueに PinVMHost propety を設定します。 したがって、サービスがデプロイされるとき、この構成で作成された仮想マシンのホストは変更されません。

例 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変数にオブジェクトを格納します。

2 番目のコマンドは、$ServiceConfigに格納されているサービス構成のコンピューター層の構成を取得し、$TierConfig変数にオブジェクトを格納します。

3 番目のコマンドは、$TierConfigに格納されているコンピューター層構成の仮想マシン構成オブジェクトを取得し、$VMConfig変数にオブジェクトを格納します。

4 番目のコマンドは、Production という名前のプライベート クラウド オブジェクトを取得し、$Cloud変数にオブジェクトを格納します。

最後のコマンドは、$Cloudに格納されているプライベート クラウドの$VMConfigに格納されている 2 番目の仮想マシン構成オブジェクトの説明を更新します。

パラメーター

-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

ユーザーの名前を指定します。 このコマンドレットは、このパラメーターで指定するユーザーとしてユーザーの代理を設定します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 このコマンドレットは、このパラメーターで指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、 Get-SCUserRole コマンドレットを 使用します。

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 ヒント) の ID を指定します。 このパラメーターを使用すると、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 コマンドレットを参照してください。

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

このコマンドレットは 、VMConfiguration オブジェクトを返します。

関連リンク

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