Join-SCVirtualMachine

분리된 가상 머신을 해당 서비스 또는 가상 머신 역할에 다시 연결합니다.

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은 분리된 가상 머신을 해당 서비스 또는 가상 머신 역할에 다시 연결합니다.

호스트 또는 클러스터가 VMM(Virtual Machine Manager)에서 제거되면 호스트에 배포된 서비스 또는 가상 머신 역할에 속하는 모든 가상 머신이 계속 작동합니다. 그러나 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 팁(성능 및 리소스 최적화 팁)의 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