Partilhar via

Get-SCOMAgent

  • Referência
Módulo:
OperationsManager

Obtém os computadores gerenciados por agente em um grupo de gerenciamento.

Sintaxe

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-DNSHostName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

O cmdlet Get-SCOMAgent obtém os computadores gerenciados por agente em um grupo de gerenciamento. Você pode especificar o parâmetro DNSHostName para obter os computadores gerenciados por agente em um host DNS (Sistema de Nomes de Domínio) ou pode especificar o parâmetro ManagementServer para obter todos os computadores gerenciados por agente filho para um servidor de gerenciamento primário.

Exemplos

Exemplo 1: Obter todos os agentes no grupo de gerenciamento

PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"

Este comando estabelece uma conexão temporária com o computador chamado Server01 e obtém todos os agentes no grupo de gerenciamento.

Exemplo 2: Obter os agentes gerenciados por um servidor de gerenciamento

PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer

Este exemplo obtém computadores gerenciados por agente que são gerenciados por um servidor de gerenciamento.

O primeiro comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e armazena o objeto na variável $MgmtServer.

O segundo comando obtém os agentes gerenciados pelo servidor de gerenciamento armazenados no $MgmtServer.

Exemplo 3: Obter agentes em um grupo de gerenciamento usando o nome do agente

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"

Este comando obtém agentes que são nomeados server01.contoso.com, que têm um nome que começa com Server02 e que estão no domínio Contoso.com.

Exemplo 4: Obter todos os agentes em um domínio

PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"

Este comando estabelece uma conexão temporária com o computador chamado Server01.Contoso.com e obtém todos os agentes no domínio Contoso.com.

Parâmetros

-ComputerName

Especifica uma matriz de nomes de 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 em execução 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

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential , use o cmdlet Get-Credential. Para obter mais informações, 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

-DNSHostName

Especifica o nome de um host DNS (Sistema de Nomes de Domínio) do computador gerenciado por agente.

Tipo:String[]
Aliases:Name
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ManagementServer

Especifica um objeto ManagementServer. Este parâmetro especifica o servidor de gerenciamento primário do qual recuperar todos os agentes filho. Para obter um objeto ManagementServer, use o cmdlet Get-SCOMManagementServer.

Tipo:ManagementServer
Aliases:MS
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection.

Um objeto de conexão representa uma conexão com um servidor de gerenciamento. O padrão é a conexão atual do grupo de gerenciamento.

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

Saídas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer