Share via

Get-SCOMAgent

  • Reference
Modul:
OperationsManager

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

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

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, který začíná serverem 02 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 doméně Contoso.com.

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 zobrazíte zadáním Get-Help Get-Credential.

Pokud zadáte počítač v parametru Názevpočítače , použijte účet, který má přístup k danému počítači. Ve výchozím nastavení je to aktuální uživatel.

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

-DNSHostName

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

Type:String[]
Aliases:Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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. K získání objektu ManagementServer použijte rutinu Get-SCOMManagementServer .

Type:ManagementServer
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

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

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

Výstupy

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer