Join-SCVirtualMachine

  • リファレンス
モジュール:
VirtualMachineManager

孤立した仮想マシンをサービスまたは仮想マシンの役割に再関連付けます。

構文

Join-SCVirtualMachine
    [-VM] <VM>
    -ComputerTier <ComputerTier>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Join-SCVirtualMachine
    [-VM] <VM>
    -VMRole <CloudVmRole>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

説明

Join-SCVirtualMachine コマンドレットは、孤立した仮想マシンをサービスまたは仮想マシンの役割に再関連付けます。

ホストまたはクラスターが Virtual Machine Manager (VMM) から削除されると、サービスに属するすべての仮想マシン、またはホストにデプロイされた仮想マシンロールが機能し続けます。 ただし、ホストまたはクラスターを VMM に追加すると、仮想マシンはサービスまたは仮想マシンの役割との関連付けがなくなったという意味で孤立します。

このコマンドレットを使用して、仮想マシンとそのサービスロールまたは仮想マシンロールの間の関連付けを復元できます。 Join-SCVirtualMachine コマンドレットは、仮想マシンとサービス テンプレートの互換性を確認するのに役立つ一連の検証を実行する再関連付けタスクを VMM で実行します。

コマンドレットでコンピューター層テンプレートとの仮想マシンの互換性が検証されると、データベースのみの操作が実行され、仮想マシンに対する調整は行われません。 仮想マシンが実行されており、その仮想マシンで実行されているすべてのゲスト アプリケーションとサービスはそのままであると想定されます。

仮想マシンに参加するコンピューター層は、最大インスタンス数を下回って実行されている必要があります。 参加操作のアップグレード ドメインは、スケールアウトに似ています。

最良の結果を得るには、このコマンドレットは、最初はサービスまたは仮想マシンロールのデプロイの一部であり、変更されていない仮想マシンと共に使用します。

例

例 1: 孤立した仮想マシンをサービス 層に参加させる

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $CT = Get-SCComputerTier -Name "MyService-WebTier" 
PS C:\> Join-SCVirtualMachine -VM $VM -ComputerTier $CT

最初のコマンドは、PS-Web-001 という名前の仮想マシンを取得し、$VM変数に格納します。

2 番目のコマンドは、MyService-WebTier という名前のコンピューター層を取得し、$CT変数に格納します。

最後のコマンドは、$VM内の仮想マシンを$CTのコンピューター層に参加します。

例 2: 孤立した仮想マシンを仮想マシンロールに参加させる

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $VmRole = Get-CloudResource -Name "ContosoShop" 
PS C:\> Join-SCVirtualMachine -VM $VM -VMRole $VmRole

最初のコマンドは、PS-Web-001 という名前の仮想マシンを取得し、$VM変数に格納します。

2 番目のコマンドは、ContosoShop という名前のクラウド リソースを取得し、それを $VmRole 変数に格納します。

最後のコマンドは、$VMの仮想マシンを$VMRoleのロールに参加します。

パラメーター

-ComputerTier

ComputerTier オブジェクトを指定します。

Type:ComputerTier
Position:Named
Default value:None
Required:True
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

-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

-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

-VM

VM オブジェクトを指定します。

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

-VMRole

CloudVMRole オブジェクトを指定します。

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