Install-SCXAgent
검색된 UNIX 및 Linux 컴퓨터에 대한 Operations Manager 에이전트를 설치합니다.
구문
Install-SCXAgent
-DiscoveryResult <DiscoveryResult[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Install-SCXAgent cmdlet은 검색된 UNIX 및 Linux 컴퓨터에 대한 Operations Manager 에이전트를 설치하고, WS-Management 통신용 인증서에 서명하고, 관리를 위해 Operations Manager에 에이전트를 등록합니다. UNIX 및 Linux 컴퓨터는 Invoke-SCXDiscovery cmdlet을 사용하여 검색해야 합니다. Invoke-SCXDiscovery cmdlet의 출력 개체는 Install-SCXAgent cmdlet에 대한 DiscoveryResult 입력으로 제공됩니다.
UNIX 또는 Linux 컴퓨터 검색에 대한 자세한 내용은 Get-Help Invoke-SCXDiscovery를 입력합니다.
이 cmdlet은 성공적으로 설치된 대상 시스템을 나타내는 관리되는 UNIX 또는 Linux 컴퓨터 개체의 배열을 반환합니다.
예제
예제 1: UNIX 및 Linux 컴퓨터 검색 및 관리 에이전트 설치
PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "Pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $MyPool -WSManCredential $WSCredential -SSHCredential $SSHCredential | Install-SCXAgent
첫 번째 명령은 Get-Credential cmdlet을 사용하여 사용자에 대한 자격 증명을 가져옵니다. 이 명령은 인증을 요청하는 메시지를 표시한 다음 결과를 $WSCredential 변수에 저장합니다.
두 번째 명령은 Get-SCXSSHCredential cmdlet을 사용하여 사용자에 대한 권한 있는 자격 증명을 만듭니다. 이 명령은 결과를 $SSHCredential 변수에 저장합니다.
세 번째 명령은 Get-SCOMResourcePool cmdlet을 사용하여 Pool01이라는 리소스 풀을 가져오고 $Pool 01 변수에 저장합니다.
최종 명령은 Invoke-SCXDiscovery cmdlet을 사용하여 IP 주소 범위 내에서 UNIX 및 Linux 컴퓨터의 검색을 호출합니다. 이 명령은 파이프라인 연산자를 사용하여 검색된 컴퓨터를 현재 cmdlet에 전달합니다. 이 명령은 관리 에이전트를 설치합니다.
매개 변수
-ComputerName
컴퓨터 이름의 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 관리 그룹과 임시 연결을 설정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.
System Center 데이터 액세스 서비스는 컴퓨터에서 활성화되어 있어야 합니다. 컴퓨터를 지정하지 않으면 cmdlet은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Credential
관리 그룹 연결이 실행되는 사용자 계정을 지정합니다.
이 매개 변수에 대해 Get-Credential cmdlet이 반환하는 것과 같은 PSCredential 개체를 지정합니다.
자격 증명 개체에 대한 자세한 내용은 Get-Help Get-Credential
입력합니다.
ComputerName 매개 변수에 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.
형식: | PSCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiscoveryResult
Invoke-SCXDiscovery cmdlet에서 반환한 대로 관리 에이전트 설치를 위해 처리할 DiscoveryResult 개체를 지정합니다.
대상 시스템을 검색하는 방법에 대한 자세한 내용은 Get-Help Invoke-SCXDiscovery
입력합니다.
형식: | DiscoveryResult[] |
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 |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
출력
Microsoft.Unix.Computer[]
이 cmdlet은 성공적으로 설치된 관리되는 UNIX 및 Linux 컴퓨터의 배열을 반환합니다.