Get-SCOMAgent
Obtém os computadores gerenciados por agente em um grupo de gerenciamento.
Sintaxe
Empty (Predefinição)
Get-SCOMAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMAgent
[-ManagementServer] <ManagementServer>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNames
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.
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 |
-Credential
Especifica 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 |
-DNSHostName
Especifica o nome de um host DNS (Sistema de Nomes de Domínio) do computador gerenciado por agente.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Nome |
Conjuntos de parâmetros
FromAgentNames
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ManagementServer
Especifica um objeto
Propriedades dos parâmetros
| Tipo: | ManagementServer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | MS |
Conjuntos de parâmetros
FromManagementServer
| Position: | 1 |
| Obrigatório: | True |
| 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 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.
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 |
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.