共用方式為

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

Description

Join-SCVirtualMachine Cmdlet 會將孤立的虛擬機與其服務或虛擬機角色建立關聯。

從 Virtual Machine Manager （VMM） 移除主機或叢集時，屬於服務或部署在主機上的虛擬機角色的任何虛擬機仍可正常運作。 不過，在將主機或叢集新增回 VMM 時，虛擬機會變得孤立，因為它們不再與其服務或虛擬機角色有任何關聯。

您可以使用此 Cmdlet 來還原虛擬機與其服務或虛擬機角色之間的關聯。 Join-SCVirtualMachine Cmdlet 會在 VMM 上執行重新關聯工作，以執行一組驗證，以協助確認虛擬機與服務範本的相容性。

當 Cmdlet 驗證虛擬機與計算機層範本的相容性時，會執行僅限資料庫作業，而且不會調整虛擬機。 假設虛擬機正在執行，且其上執行的所有客體應用程式和服務都完好無損。

您要加入虛擬機的計算機層必須低於其實例計數上限。 聯結作業的升級網域類似於向外延展。

為了獲得最佳結果，請使用此 Cmdlet 搭配原本屬於服務或虛擬機角色部署的虛擬機，且未修改。

範例

範例 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變數中。

第二個命令會取得名為 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變數中。

第二個命令會取得名為 ContosoShop 的雲端資源，然後將它儲存在 $VmRole 變數中。

最後一個命令會將 $VM 中的虛擬機聯結至 $VMRole 中的角色。

參數

-ComputerTier

指定 ComputerTier 物件。

類型:ComputerTier
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定追蹤和儲存作業進度的變數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUser

指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。

類型:UserRole
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VM

指定 VM 物件。

類型:VM
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-VMRole

指定 CloudVMRole 物件。

類型:CloudVmRole
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False