Get-SCOMAgent

참조

모듈:: OperationsManager

관리 그룹의 에이전트 관리 컴퓨터를 가져옵니다.

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

Get-SCOMAgent cmdlet은 관리 그룹에서 에이전트 관리 컴퓨터를 가져옵니다. DNSHostName 매개 변수를 지정하여 DNS(Domain Name System) 호스트에서 에이전트 관리 컴퓨터를 얻거나 ManagementServer 매개 변수를 지정하여 기본 관리 서버에 대한 모든 자식 에이전트 관리 컴퓨터를 가져올 수 있습니다.

예제

예제 1: 관리 그룹의 모든 에이전트 가져오기

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

이 명령은 Server01이라는 컴퓨터와 임시 연결을 설정하고 관리 그룹의 모든 에이전트를 가져옵니다.

예제 2: 관리 서버에서 관리하는 에이전트 가져오기

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

이 예제에서는 관리 서버에서 관리되는 에이전트 관리 컴퓨터를 가져옵니다.

첫 번째 명령은 MgmtServer01.Contoso.com 관리 서버 개체를 가져오고 $MgmtServer 변수에 개체를 저장합니다.

두 번째 명령은 $MgmtServer 저장된 관리 서버에서 관리하는 에이전트를 가져옵니다.

예제 3: 에이전트 이름을 사용하여 관리 그룹의 에이전트 가져오기

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

이 명령은 server01.contoso.com 이름이 지정되고 이름이 Server02로 시작하며 Contoso.com 도메인에 있는 에이전트를 가져옵니다.

예제 4: 도메인의 모든 에이전트 가져오기

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

이 명령은 Server01.Contoso.com 컴퓨터와 임시 연결을 설정하고 Contoso.com 도메인의 모든 에이전트를 가져옵니다.

매개 변수

-ComputerName

컴퓨터 이름의 배열을 지정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.

System Center 데이터 액세스 서비스가 컴퓨터에서 실행 중이어야 합니다. 컴퓨터를 지정하지 않으면 cmdlet은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.

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

-Credential

관리 그룹 연결에 대한 PSCredential 개체를 지정합니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용을 보려면 Get-Help Get-Credential를 입력하십시오.

ComputerName 매개 변수에 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.

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

-DNSHostName

에이전트 관리 컴퓨터의 DNS(Domain Name System) 호스트의 이름을 지정합니다.

Type:	String[]
Aliases:	Name
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementServer

ManagementServer 개체를 지정합니다. 이 매개 변수는 모든 자식 에이전트를 검색할 기본 관리 서버를 지정합니다. ManagementServer 개체를 가져오려면 Get-SCOMManagementServer cmdlet을 사용합니다.

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

-SCSession

Connection 개체의 배열을 지정합니다. Connection 개체를 가져오려면 Get-SCOMManagementGroupConnection cmdlet을 사용합니다.

연결 개체는 관리 서버에 대한 연결을 나타냅니다. 기본값은 현재 관리 그룹 연결입니다.

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

출력

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer