共用方式為

Join-SCVirtualMachine

  • 參考
模組:
VirtualMachineManager

重新建立孤立虛擬機器與其服務或虛擬機器角色的關聯。

Syntax

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 物件。

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

指定使用者名稱。 這個 Cmdlet 會代表此參數所指定的使用者運作。

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

-OnBehalfOfUserRole

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

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

-PROTipID

指定觸發此動作 (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

-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