Remove-SCXAgent

从管理组中删除目标托管 UNIX 和 Linux 计算机。

语法

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

说明

Remove-SCXAgent cmdlet 从管理组中删除目标托管 UNIX 和 Linux 计算机。 托管 UNIX 和 Linux 计算机作为 UNIX 和 Linux 计算机对象的数组传递给 Remove-SCXAgent cmdlet。

有关检索托管 UNIX 和 Linux 计算机的信息,请参阅 Get-SCXAgent cmdlet。

此 cmdlet 不返回任何输出。

示例

示例 1:删除管理代理

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

第一个命令使用 Get-SCXAgent cmdlet 获取与指定名称匹配的托管 Linux 或 UNIX 计算机的代理。 该命令将结果存储在$Agents数组变量中。

最后一个命令删除$Agents中的代理。

示例 2:使用定义的运行方式帐户卸载管理代理

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

此命令使用 Get-SCXAgent获取与指定名称匹配的托管 Linux 或 UNIX 计算机的代理。 该命令将代理传递到当前 cmdlet。 该命令删除管理代理。

参数

-Agent

指定一个或多个托管 UNIX 和 Linux 计算机对象。 有关如何获取托管 UNIX 或 Linux 计算机对象的信息,请键入 Get-Help Get-SCXAgent

类型:IPersistedUnixComputer[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ComputerName

指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名(FQDN)。 若要指定本地计算机,请键入计算机名称、localhost 或点(.)。

System Center Data Access 服务必须在计算机上处于活动状态。 如果未指定计算机,该 cmdlet 将使用计算机进行当前管理组连接。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Credential

指定运行管理组连接的用户帐户。 为此参数指定 PSCredential 对象,例如 Get-Credential cmdlet 返回的对象。 有关凭据对象的详细信息,请键入 Get-Help Get-Credential

如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SCSession

指定 连接 对象的数组。 若要获取 连接 对象,请使用 Get-SCOMManagementGroupConnection cmdlet。

如果未指定此参数,cmdlet 将使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerNameCredential 参数创建与管理组的临时连接。 有关详细信息,请键入 Get-Help about_OpsMgr_Connections

类型:Connection[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输出

此 cmdlet 不生成任何输出。 Remove-SCXAgent cmdlet 没有失败情况。