Join-SCVirtualMachine
Повторно связывает потерянную виртуальную машину с ее службой или ролью виртуальной машины.
Синтаксис
ServiceComputerTierParameterSet
Join-SCVirtualMachine
[-VM] <VM>
-ComputerTier <ComputerTier>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VMRoleParameterSet
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.
Вторая команда получает уровень компьютера с именем 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ServiceComputerTierParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobVariable
Указывает переменную, в которой отслеживается и сохраняется ход выполнения задания.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.
Свойства параметра
| Тип: | UserRole |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VM
Указывает объект виртуальной машины .
Свойства параметра
| Тип: | VM |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMRole
Указывает объект CloudVMRole .
Свойства параметра
| Тип: | CloudVmRole |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VMRoleParameterSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Связанные ссылки
- Get-SCVirtualMachine
- Move-SCVirtualMachine
- New-SCVirtualMachine
- Read-SCVirtualMachine
- Register-SCVirtualMachine
- Remove-SCVirtualMachine
- Repair-SCVirtualMachine
- Reset-SCVirtualMachine
- Resume-SCVirtualMachine
- Save-SCVirtualMachine
- Set-SCVirtualMachine
- Start-SCVirtualMachine
- Stop-SCVirtualMachine
- Suspend-SCVirtualMachine