Remove-SCAdvisorAgent
Quita uno o varios agentes del grupo de agentes que informan al conector de Advisor.
Syntax
Remove-SCAdvisorAgent
[-InputObjects <PartialMonitoringObject[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Remove-SCAdvisorAgent quita uno o varios agentes del grupo de agentes que informan al conector de System Center Advisor.
Ejemplos
Ejemplo 1: Quitar agentes por nombre de un grupo de equipos
PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputersEl primer comando usa el cmdlet Get-SCClass para obtener todos los equipos basados en Windows, pasa esos equipos al cmdlet Get-SCOMClassInstance mediante el operador de canalización y, a continuación, usa el cmdlet Where-Object para buscar equipos que contengan el nombre ContosoAgent.
El comando almacena estas instancias en la variable $WindowsComputers.
Para obtener más información, escriba Get-Help Where-Object.
El segundo comando quita todos los agentes almacenados en $WindowsComputers del grupo de agentes que informan al conector de Advisor.
Ejemplo 2: Quitar agentes por nombre de un equipo
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"El primer comando usa Get-SCClass para obtener todos los equipos basados en Windows, pasa esos equipos a Get-SCOMClassInstance mediante el operador de canalización para buscar Computer062 y, a continuación, usa Where-Object para buscar agentes que contienen el nombre ContosoAgent. El comando almacena estas instancias en la variable $WindowsComputers.
El segundo comando quita todos los equipos basados en Windows almacenados en $WindowsComputers del grupo de agentes que informan al conector de Advisor.
Parámetros
-ComputerName
Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).
El servicio de acceso a datos de System Center debe estar activo en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración.
Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro.
Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.
Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObjects
Especifica una matriz de nombres de equipo para no participar en el conector de Advisor.
| Type: | PartialMonitoringObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Especifica una matriz de objetos Connection . Para obtener objetos Connection , use el cmdlet Get-SCOMManagementGroupConnection .
Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración.
Use el parámetro SCSession para especificar una conexión persistente diferente.
Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential .
Para obtener más información, escriba Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |