Dela via

Get-SCOMAgent

  • Referens
Modul:
OperationsManager

Hämtar de agenthanterade datorerna i en hanteringsgrupp.

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

Cmdleten Get-SCOMAgent hämtar de agenthanterade datorerna i en hanteringsgrupp. Du kan ange parametern DNSHostName för att hämta agenthanterade datorer på en DNS-värd (Domain Name System), eller ange parametern ManagementServer för att hämta alla underordnade agenthanterade datorer för en primär hanteringsserver.

Exempel

Exempel 1: Hämta alla agenter i hanteringsgruppen

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

Det här kommandot upprättar en tillfällig anslutning till datorn med namnet Server01 och hämtar alla agenter i hanteringsgruppen.

Exempel 2: Hämta agenter som hanteras av en hanteringsserver

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

Det här exemplet hämtar agenthanterade datorer som hanteras av en hanteringsserver.

Det första kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar objektet i variabeln $MgmtServer.

Det andra kommandot hämtar de agenter som hanteras av hanteringsservern som lagras i $MgmtServer.

Exempel 3: Hämta agenter i en hanteringsgrupp med hjälp av agentnamnet

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

Det här kommandot hämtar agenter med namnet server01.contoso.com, som har ett namn som börjar med Server02 och som finns i domänen Contoso.com.

Exempel 4: Hämta alla agenter i en domän

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

Det här kommandot upprättar en tillfällig anslutning till datorn med namnet Server01.Contoso.com och hämtar alla agenter i domänen Contoso.com.

Parametrar

-ComputerName

Anger en matris med namn på datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste köras på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett PSCredential- objekt för hanteringsgruppens anslutning. Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DNSHostName

Anger namnet på en DNS-värd (Domain Name System) för den agenthanterade datorn.

Typ:String[]
Alias:Name
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ManagementServer

Anger ett ManagementServer- objekt. Den här parametern anger den primära hanteringsserver som alla underordnade agenter ska hämtas från. Om du vill hämta ett ManagementServer--objekt använder du cmdleten Get-SCOMManagementServer.

Typ:ManagementServer
Alias:MS
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta ett --objekt använder du cmdleten Get-SCOMManagementGroupConnection.

Ett anslutningsobjekt representerar en anslutning till en hanteringsserver. Standardvärdet är den aktuella hanteringsgruppens anslutning.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer