Compartilhar via

Get-SCOMAgent

  • Referência
Módulo:
OperationsManager

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

Syntax

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 pelo agente em um grupo de gerenciamento. Você pode especificar o parâmetro DNSHostName para obter os computadores gerenciados pelo agente em um host DNS (Sistema de Nomes de Domínio) ou 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"

Esse 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 de 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 armazenado em $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"

Esse comando obtém agentes 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"

Esse 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 do grupo de gerenciamento atual.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DNSHostName

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

Type:String[]
Aliases:Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

Especifica um objeto ManagementServer . Esse 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 .

Type:ManagementServer
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 de grupo de gerenciamento.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer