Sdílet prostřednictvím

Get-SCOMAgent

  • Reference
Modul:
OperationsManager

Získá počítače spravované agentem ve skupině pro správu.

Syntaxe

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

Rutina Get-SCOMAgent získá počítače spravované agentem ve skupině pro správu. Můžete zadat parametr DNSHostName pro získání počítačů spravovaných agentem na hostiteli DNS (Domain Name System) nebo můžete zadat parametr ManagementServer pro získání všech podřízených počítačů spravovaných agentem pro primární server pro správu.

Příklady

Příklad 1: Získání všech agentů ve skupině pro správu

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

Tento příkaz vytvoří dočasné připojení k počítači s názvem Server01 a získá všechny agenty ve skupině pro správu.

Příklad 2: Získání agentů spravovaných serverem pro správu

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

Tento příklad získá počítače spravované agentem spravované serverem pro správu.

První příkaz získá objekt serveru pro správu s názvem MgmtServer01.Contoso.com a uloží objekt do proměnné $MgmtServer.

Druhý příkaz získá agenty spravované serverem pro správu uloženým v $MgmtServer.

Příklad 3: Získání agentů ve skupině pro správu pomocí názvu agenta

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

Tento příkaz získá agenty s názvem server01.contoso.com, které mají název začínající serverem Server02 a které jsou v Contoso.com doméně.

Příklad 4: Získání všech agentů v doméně

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

Tento příkaz vytvoří dočasné připojení k počítači s názvem Server01.Contoso.com a získá všechny agenty v Contoso.com doméně.

Parametry

-ComputerName

Určuje pole názvů počítačů. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Na počítači musí být spuštěná služba System Center Data Access. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení skupiny pro správu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje objekt PSCredential pro připojení skupiny pro správu. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Pokud zadáte počítač v parametru ComputerName, použijte účet, který má přístup k danému počítači. Výchozí hodnota je aktuální uživatel.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DNSHostName

Určuje název hostitele DNS (Domain Name System) počítače spravovaného agentem.

Typ:String[]
Aliasy:Name
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ManagementServer

Určuje objekt ManagementServer. Tento parametr určuje primární server pro správu, ze kterého se mají načíst všichni podřízení agenti. Pokud chcete získat objekt ManagementServer, použijte rutinu Get-SCOMManagementServer.

Typ:ManagementServer
Aliasy:MS
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SCSession

Určuje pole objektů Connection. K získání objektu připojení použijte rutinu Get-SCOMManagementGroupConnection.

Objekt připojení představuje připojení k serveru pro správu. Výchozí hodnotou je aktuální připojení skupiny pro správu.

Typ:Connection[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer