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 $WindowsComputers
El 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 |