Get-SCXAgent
관리 그룹의 관리되는 UNIX 및 Linux 컴퓨터 목록을 가져옵니다.
구문
Get-SCXAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCXAgent
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCXAgent
-ID <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCXAgent
-ResourcePool <ManagementServicePool>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
Get-SCXAgent cmdlet은 제공된 선택 조건과 일치하는 관리되는 UNIX 및 Linux 컴퓨터를 검색합니다. 선택 조건을 지정하지 않으면 관리 그룹의 모든 관리 UNIX 및 Linux 컴퓨터가 반환됩니다.
결과는 관리되는 UNIX 및 Linux 컴퓨터 개체의 배열로 반환됩니다.
예제
예제 1: 관리되는 UNIX 및 Linux 컴퓨터 반환
PS C:\>Get-SCXAgent
이 명령은 리소스 풀에서 관리되는 모든 UNIX 및 Linux 컴퓨터를 반환합니다.
예제 2: 리소스 풀에서 관리되는 UNIX 및 Linux 컴퓨터 반환
PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool
첫 번째 명령은 Get-SCOMResourcePool cmdlet을 사용하여 리소스 풀을 가져오고 $ResourcePool 변수에 저장합니다.
두 번째 명령은 $ResourcePool 리소스 풀에 대해 관리되는 모든 UNIX 및 Linux 컴퓨터를 반환합니다.
예제 3: 이름을 사용하여 관리되는 UNIX 및 Linux 컴퓨터 반환
PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"
이 명령은 제공된 문자열 목록과 일치하는 이름으로 관리되는 UNIX 및 Linux 컴퓨터를 반환합니다.
예제 4: 파이프라인을 사용하여 관리되는 UNIX 및 Linux 컴퓨터 반환
PS C:\>"server1", "server2", "server3" | Get-SCXAgent
이 명령은 파이프라인을 통해 Name 매개 변수를 제공합니다.
예제 5: 리소스 풀에 연결하고 이름으로 관리되는 컴퓨터를 가져옵니다.
PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"
이 명령은 현재 사용자의 자격 증명을 사용하여 임시 연결이 있는 리소스 풀에 연결하고 Name 속성과 일치하는 관리 컴퓨터만 반환합니다.
매개 변수
-ComputerName
컴퓨터 이름의 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 관리 그룹과 임시 연결을 설정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.
System Center 데이터 액세스 서비스는 컴퓨터에서 활성화되어 있어야 합니다. 컴퓨터를 지정하지 않으면 cmdlet은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Credential
관리 그룹 연결이 실행되는 사용자 계정을 지정합니다.
이 매개 변수에 대해 Get-Credential cmdlet이 반환하는 것과 같은 PSCredential 개체를 지정합니다.
자격 증명 개체에 대한 자세한 내용은 Get-Help Get-Credential
입력합니다.
ComputerName 매개 변수에 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.
형식: | PSCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ID
관리되는 UNIX 또는 Linux 컴퓨터 개체의 ID를 지정합니다. 이 값과 일치하는 ID 속성이 있는 관리되는 컴퓨터만 반환합니다. 이 매개 변수는 파이프라인에서 허용됩니다.
형식: | Guid[] |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
하나 이상의 관리되는 UNIX 및 Linux 컴퓨터에 대한 정규화된 도메인 이름 목록을 지정합니다. Name 속성과 일치하는 관리 컴퓨터만 반환합니다.
와일드카드를 포함할 수 있습니다. 이 경우 와일드카드와 일치하는 모든 컴퓨터가 반환됩니다.
와일드카드 사용에 대한 자세한 내용은 Get-Help About_Wildcards
입력합니다.
이 매개 변수는 파이프라인에서 허용됩니다.
형식: | String[] |
별칭: | DisplayName |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ResourcePool
서버의 리소스 풀을 지정합니다. 그 중 하나는 현재 관리 서버로 할당되고 다른 하나는 백업 관리 서버로 사용됩니다. 이 매개 변수는 리소스 풀 개체가 필요하며 해당 리소스 풀의 관리 컴퓨터만 반환합니다.
SCOMResourcePool 개체를 가져오는 방법에 대한 자세한 내용은 Get-Help Get-SCOMResourcePool
입력합니다.
형식: | ManagementServicePool |
별칭: | RP |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SCSession
Connection 개체의 배열을 지정합니다. Connection 개체를 얻으려면 Get-SCOMManagementGroupConnection cmdlet을 사용합니다.
이 매개 변수를 지정하지 않으면 cmdlet은 관리 그룹에 대한 활성 영구 연결을 사용합니다.
SCSession 매개 변수를 사용하여 다른 영구 연결을 지정합니다.
ComputerName 및 자격 증명 매개 변수를 사용하여 관리 그룹에 대한 임시 연결을 만들 수 있습니다.
자세한 내용은 Get-Help about_OpsMgr_Connections
입력합니다.
형식: | Connection[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
출력
Microsoft.Unix.Computer[]
이 cmdlet은 UNIX 및 Linux 컴퓨터가 입력 조건과 일치할 때 관리되는 UNIX 및 Linux 컴퓨터를 나타내는 하나 이상의 컴퓨터 개체를 반환합니다.