Поделиться через

Uninstall-SCOMAgent

  • Ссылка
Модуль:
OperationsManager

Удаляет агенты с управляемых агентом компьютеров.

Синтаксис

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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Agent

Задает массив объектов AgentManagedComputer. Этот параметр указывает агенты Operations Manager для удаления. Чтобы получить объект AgentManagedComputer, используйте командлет Get-SCOMADAgent.

Тип:AgentManagedComputer[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Выходные данные

Microsoft.EnterpriseManagement.Administration.AgentTaskResult