次の方法で共有

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 オブジェクトを指定します。

型:ComputerTier
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

ジョブの進行状況を追跡して格納する変数を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

型:UserRole
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VM

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

型:VM
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VMRole

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

型:CloudVmRole
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False