Remove-SCAdvisorAgent
Remove um ou mais agentes do grupo de agentes que se reportam ao Advisor Connector.
Sintaxe
Default (Predefinição)
Remove-SCAdvisorAgent
[-InputObjects <PartialMonitoringObject[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-SCAdvisorAgent remove um ou mais agentes do grupo de agentes que se reportam ao System Center Advisor Connector.
Exemplos
Exemplo 1: Remover agentes por nome de um grupo de computadores
PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers
O primeiro comando usa o cmdlet Get-SCClass para obter todos os computadores baseados no Windows, passa esses computadores para o cmdlet Get-SCOMClassInstance usando o operador de pipeline e, em seguida, usa o cmdlet Where-Object para localizar computadores que contêm o nome ContosoAgent.
O comando armazena essas instâncias na variável $WindowsComputers.
Para obter mais informações, digite Get-Help Where-Object.
O segundo comando remove todos os agentes armazenados em $WindowsComputers do grupo de agentes que se reportam ao Advisor Connector.
Exemplo 2: Remover agentes por nome de um computador
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"
O primeiro comando usa Get-SCClass para obter todos os computadores baseados no Windows, passa esses computadores para Get-SCOMClassInstance usando o operador de pipeline para localizar Computer062 e, em seguida, usa Where-Object para localizar agentes que contêm o nome ContosoAgent. O comando armazena essas instâncias na variável $WindowsComputers.
O segundo comando remove todos os computadores baseados no Windows armazenados em $WindowsComputers do grupo de agentes que se reportam ao Advisor Connector.
Parâmetros
-ComputerName
Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).
O serviço de Acesso a Dados do System Center deve estar ativo no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão atual do grupo de gerenciamento.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica a conta de usuário sob a qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto PSCredential Get-Help Get-Credential.
Se você especificar um computador no parâmetro
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObjects
Especifica uma matriz de nomes de computador para desativar do Advisor Connector.
Propriedades dos parâmetros
| Tipo: | PartialMonitoringObject[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma matriz de objetos Connection. Para obter objetos Connection, use o cmdlet Get-SCOMManagementGroupConnection.
Se esse parâmetro não for especificado, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento.
Use o parâmetro SCSession para especificar uma conexão persistente diferente.
Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential.
Para obter mais informações, digite Get-Help about_OpsMgr_Connections.
Propriedades dos parâmetros
| Tipo: | Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.