다음을 통해 공유

Get-SCOMAgent

  • 참조
모듈:
OperationsManager

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

구문

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은 관리 그룹에서 에이전트 관리 컴퓨터를 가져옵니다. DNS(Domain Name System) 호스트에서 에이전트 관리 컴퓨터를 가져오기 위해 DNSHostName 매개 변수를 지정하거나 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은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

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

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

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DNSHostName

에이전트 관리 컴퓨터의 DNS(도메인 이름 시스템) 호스트의 이름을 지정합니다.

형식:String[]
별칭:Name
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ManagementServer

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

형식:ManagementServer
별칭:MS
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SCSession

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

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

형식:Connection[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer