Remove-SCAdvisorAgent

从向顾问连接器报告的代理组中删除一个或多个代理。

语法

Default (默认值)

Remove-SCAdvisorAgent
    [-InputObjects <PartialMonitoringObject[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Remove-SCAdvisorAgent cmdlet 从向 System Center 顾问连接器报告的代理组中删除一个或多个代理。

示例

示例 1:按名称从一组计算机中删除代理

PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers

第一个命令使用 Get-SCClass cmdlet 获取所有基于 Windows 的计算机,使用管道运算符将这些计算机传递到 Get-SCOMClassInstance cmdlet,然后使用 Where-Object cmdlet 查找包含名称 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 的计算机,使用管道运算符查找 Computer062,然后使用 Where-Object 查找包含 ContosoAgent 名称的代理,将这些计算机传递给 Get-SCOMClassInstance。 该命令将这些实例存储在$WindowsComputers变量中。

第二个命令从向顾问连接器报告的代理组中删除存储在 $WindowsComputers 中的所有基于 Windows 的计算机。

参数

-ComputerName

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

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Credential

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

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObjects

指定要退出顾问连接器的计算机名称数组。

参数属性

类型:

PartialMonitoringObject[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SCSession

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

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

参数属性

类型:

Connection[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

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

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters