Uninstall-SCOMAgent
Удаляет агенты с управляемых агентом компьютеров.
Синтаксис
Default (по умолчанию)
Uninstall-SCOMAgent
[-ActionAccount <PSCredential>]
-Agent <AgentManagedComputer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Uninstall-SCOMAgent удаляет агенты с управляемых агентами компьютеров. Перед удалением агента необходимо удалить назначения агента доменных служб Active Directory (AD DS) из группы управления. Вы можете использовать Remove-SCOMADAgentAssignment cmdet для удаления назначений агентов AD DS из группы управления.
Примеры
Пример 1. Удаление агента
PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent
Первая команда получает объект агента Operations Manager с именем server01.contoso.com и передает его в командлет Uninstall-SCOMAgent с помощью оператора конвейера. Вторая команда удаляет агент с именем server01.contoso.com.
Пример 2. Удаление агента с помощью переменной объекта
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent
В этом примере агент Operations Manager удаляется на управляемом агентом компьютере.
Первая команда получает управляемый агентом объект компьютера с именем server01.contoso.com и сохраняет объект в переменной $Agent.
Вторая команда удаляет агент, хранящийся в $Agent.
Пример 3. Удаление агента с помощью учетной записи действия
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)
В этом примере агент Operations Manager удаляется на управляемом агентом компьютере после ввода пользователем учетных данных, необходимых Operations Manager для удаления агента.
Первая команда получает объект агента с именем server01.contoso.com и сохраняет объект в переменной $Agent.
Вторая команда предложит пользователю ввести учетные данные, которые Operations Manager использует для удаления агента. Затем команда удаляет агент, хранящийся в $Agent.
Параметры
-ActionAccount
Указывает объект PSCredential. Этот параметр указывает учетные данные, которые Operations Manager использует для выполнения задачи развертывания. Если этот параметр не указан или указано значение NULL, Operations Manager использует учетную запись действия по умолчанию сервера управления для агента.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Agent
Задает массив объектов AgentManagedComputer. Этот параметр указывает агенты Operations Manager для удаления. Чтобы получить объект AgentManagedComputer, используйте командлет Get-SCOMADAgent.
Свойства параметра
| Тип: | AgentManagedComputer[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.
Свойства параметра
| Тип: | SwitchParameter |
| 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.