Uninstall-SCXAgent

Модуль:
OperationsManager Module

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

Синтаксис

Default (по умолчанию) 

Uninstall-SCXAgent
    -Agent <IPersistedUnixComputer[]>
    [-SshCredential <CredentialSet>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Uninstall-SCXAgent удаляет агент управления на указанных компьютерах UNIX и Linux.

Обязательный параметр агента указывает целевые управляемые компьютеры UNIX или Linux для удаления и требуют объекта компьютера UNIX или Linux. Сведения о получении управляемых компьютеров UNIX или Linux см. в командлете Get-SCXAgent. Необязательный параметр SSHCredential можно указать для идентификации привилегированных учетных данных, используемых для удаления агента управления. Если SSHCredential не указано, командлет пытается использовать определенную учетную запись привилегированного запуска от имени для агента.

Этот командлет не возвращает выходные данные.

Примеры

Пример 1. Удаление агента управления

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

Первая команда получает агент для управляемого компьютера Linux или UNIX с именем nx1.contoso.com с помощью командлета Get-SCXAgent. Команда сохраняет ее в переменной $Agent 01.

Вторая команда создает привилегированные учетные данные для пользователя с помощью командлета Get-SCXSSHCredential. Команда сохраняет результат в переменной $SSHCredential.

Последняя команда удаляет агент управления в $Agent 01 с помощью указанных учетных данных SSH.

Пример 2. Удаление агента управления с определенной учетной записью запуска от имени

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-SCXAgent

Эта команда получает агент для управляемого компьютера Linux или UNIX с именем nx1.contoso.com с помощью Get-SCXAgent. Команда передает управляемый компьютер текущему командлету. Команда удаляет агент управления с помощью определенной учетной записи запуска от имени.

Параметры

-Agent

Указывает один или несколько управляемых объектов компьютера UNIX или Linux. Сведения о том, как получить управляемый объект компьютера UNIX или Linux, введите Get-Help Get-SCXAgent.

Свойства параметра

Тип:

IPersistedUnixComputer[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-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

-SCSession

Задает массив объектов подключения . Чтобы получить объекты подключения , используйте командлет Get-SCOMManagementGroupConnection.

Если этот параметр не указан, командлет использует активное постоянное подключение к группе управления. Используйте параметр SCSession для указания другого постоянного подключения. Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных. Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.

Свойства параметра

Тип:

Connection[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SshCredential

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

Сведения о том, как получить объект учетных данных SSH, введите Get-Help Get-SCXSSHCredential.

Свойства параметра

Тип:CredentialSet
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.

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

undefined

Этот командлет возвращает результаты, представляющие состояние удаления компьютера. Результаты содержат следующие сведения:

  • Имя узла
  • Состояние удаления
  • Описание

Описание содержит сведения о том, почему удаление завершилось сбоем.