Udostępnij przez


Get-SCOMAgent

Pobiera komputery zarządzane przez agenta w grupie zarządzania.

Składnia

Empty (Domyślna)

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>]

Opis

Polecenie cmdlet Get-SCOMAgent pobiera komputery zarządzane przez agenta w grupie zarządzania. Można określić DNSHostName parametr, aby pobrać komputery zarządzane przez agenta na hoście systemu nazw domen (DNS) lub można określić ManagementServer parametr, aby pobrać wszystkie komputery zarządzane przez agenta podrzędnego dla podstawowego serwera zarządzania.

Przykłady

Przykład 1. Pobieranie wszystkich agentów w grupie zarządzania

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

To polecenie ustanawia tymczasowe połączenie z komputerem o nazwie Server01 i pobiera wszystkich agentów w grupie zarządzania.

Przykład 2. Pobieranie agentów zarządzanych przez serwer zarządzania

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

Ten przykład umożliwia pobranie komputerów zarządzanych przez agenta zarządzanych przez serwer zarządzania.

Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i przechowuje obiekt w zmiennej $MgmtServer.

Drugie polecenie pobiera agentów zarządzanych przez serwer zarządzania przechowywany w $MgmtServer.

Przykład 3. Pobieranie agentów w grupie zarządzania przy użyciu nazwy agenta

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

To polecenie pobiera agentów o nazwie server01.contoso.com, które mają nazwę rozpoczynającą się od Server02 i które znajdują się w domenie Contoso.com.

Przykład 4. Pobieranie wszystkich agentów w domenie

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

To polecenie ustanawia tymczasowe połączenie z komputerem o nazwie Server01.Contoso.com i pobiera wszystkich agentów w domenie Contoso.com.

Parametry

-ComputerName

Określa tablicę nazw komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Na komputerze musi być uruchomiona usługa System Center Data Access. Jeśli komputer nie zostanie określony, polecenie cmdlet używa komputera dla bieżącego połączenia grupy zarządzania.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Credential

Określa obiekt PSCredential dla połączenia grupy zarządzania. Aby uzyskać obiekt PSCredential, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.

Jeśli określisz komputer w parametrze ComputerName, użyj konta, które ma dostęp do tego komputera. Wartość domyślna to bieżący użytkownik.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DNSHostName

Określa nazwę hosta systemu nazw domen (DNS) komputera zarządzanego przez agenta.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Nazwa

Zestawy parametrów

FromAgentNames
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ManagementServer

Określa obiekt ManagementServer. Ten parametr określa podstawowy serwer zarządzania, z którego mają być pobierane wszystkie agenty podrzędne. Aby uzyskać obiekt ManagementServer, użyj polecenia cmdlet Get-SCOMManagementServer.

Właściwości parametru

Typ:ManagementServer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:MS

Zestawy parametrów

FromManagementServer
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SCSession

Określa tablicę obiektów połączenia . Aby uzyskać obiekt Connection, użyj polecenia cmdlet Get-SCOMManagementGroupConnection.

Obiekt połączenia reprezentuje połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.

Właściwości parametru

Typ:

Connection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer