Partilhar via

Remove-SCAdvisorAgent

  • Referência
Módulo:
OperationsManager

Remove um ou mais agentes do grupo de agentes que se reportam ao Advisor Connector.

Sintaxe

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.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica a conta de usuário sob a qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObjects

Especifica uma matriz de nomes de computador para desativar do Advisor Connector.

Tipo:PartialMonitoringObject[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Connection[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False