Remove-SCAdvisorAgent
Удаляет один или несколько агентов из группы агентов, сообщающих соединителю Помощника.
Синтаксис
Default (по умолчанию)
Remove-SCAdvisorAgent
[-InputObjects <PartialMonitoringObject[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет remove-SCAdvisorAgent удаляет один или несколько агентов из группы агентов, сообщающих соединителю System Center Advisor.
Примеры
Пример 1. Удаление агентов по имени из группы компьютеров
PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers
Первая команда использует командлет Get-SCClass для получения всех компьютеров под управлением Windows, передает эти компьютеры в командлет Get-SCOMClassInstance с помощью оператора конвейера, а затем использует командлет Where-Object для поиска компьютеров с именем ContosoAgent.
Команда сохраняет эти экземпляры в переменной $WindowsComputers.
Дополнительные сведения см. в Get-Help Where-Object.
Вторая команда удаляет все агенты, хранящиеся в $WindowsComputers, из группы агентов, сообщающих соединителю Помощника.
Пример 2. Удаление агентов по имени с компьютера
PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance -ComputerName "Computer062" | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers -ComputerName "Computer062"
Первая команда использует Get-SCClass для получения всех компьютеров под управлением Windows, передает эти компьютеры в Get-SCOMClassInstance с помощью оператора конвейера для поиска Computer062, а затем использует Where-Object для поиска агентов, содержащих имя ContosoAgent. Команда сохраняет эти экземпляры в переменной $WindowsComputers.
Вторая команда удаляет все компьютеры под управлением Windows, хранящиеся в $WindowsComputers, из группы агентов, сообщающих соединителю Помощника.
Параметры
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Служба доступа к данным System Center должна быть активной на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, в которой выполняется подключение группы управления.
Укажите объект PSCredential, например объект get-Credential для этого параметра.
Дополнительные сведения об объектах учетных данных введите Get-Help Get-Credential.
Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObjects
Указывает массив имен компьютеров, которые следует отказаться от соединителя Помощника.
Свойства параметра
| Тип: | PartialMonitoringObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Задает массив объектов подключения
Если этот параметр не указан, командлет использует активное постоянное подключение к группе управления.
Используйте параметр SCSession для указания другого постоянного подключения.
Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных.
Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.
Свойства параметра
| Тип: | Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.