Partilhar via

Get-SCOMAgent

  • Referência
Módulo:
OperationsManager

Arranja os computadores geridos pelo agente num grupo de gestão.

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 recebe os computadores geridos pelo agente num grupo de gestão. Pode especificar o parâmetro DNSHostName para obter os computadores geridos pelo agente num anfitrião do Sistema de Nome de Domínio (DNS) ou pode especificar o parâmetro ManagementServer para obter todos os computadores geridos por agentes infantis para um servidor de gestão primária.

Exemplos

Exemplo 1: Obter todos os agentes no grupo de gestão

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

Este comando estabelece uma ligação temporária com o computador chamado Server01 e recebe todos os agentes do grupo de gestão.

Exemplo 2: Obter os agentes geridos por um servidor de gestão

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

Este exemplo obtém computadores geridos por agentes que são geridos por um servidor de gestão.

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

O segundo comando recebe os agentes que são geridos pelo servidor de gestão armazenados em $MgmtServer.

Exemplo 3: Obter agentes num grupo de gestão 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 num domínio

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

Este comando estabelece uma ligaçã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 série de nomes de computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de acesso a dados do Centro de Sistemas deve estar a funcionar no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão 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 ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

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

-DNSHostName

Especifica o nome de um anfitrião do Sistema de Nome de Domínio (DNS) do computador gerido 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 . Este parâmetro especifica o servidor de gestão primária a partir do qual recuperar todos os agentes infantis. Para obter um objeto ManagementServer , utilize 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 de ligação . Para obter um objeto de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Um objeto de ligação representa uma ligação a um servidor de gestão. O padrão é a ligação do grupo de gestão atual.

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

Saídas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer