Install-SCXAgent

  • 참조
모듈:
OperationsManager

검색된 UNIX 및 Linux 컴퓨터에 대한 Operations Manager 에이전트를 설치합니다.

Syntax

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에 에이전트를 등록합니다. Invoke-SCXDiscovery cmdlet을 사용하여 UNIX 및 Linux 컴퓨터를 검색해야 합니다. 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은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

관리 그룹 연결이 실행되는 사용자 계정을 지정합니다. 이 매개 변수에 대해 Get-Credential cmdlet이 반환하는 것과 같은 PSCredential 개체를 지정합니다. 자격 증명 개체에 대한 자세한 내용을 보려면 .를 입력합니다 Get-Help Get-Credential.

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

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

-DiscoveryResult

Invoke-SCXDiscovery cmdlet에서 반환한 대로 관리 에이전트 설치를 위해 처리할 DiscoveryResult 개체를 지정합니다.

대상 시스템을 검색하는 방법에 대한 자세한 내용은 다음을 입력합니다 Get-Help Invoke-SCXDiscovery.

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

-SCSession

Connection 개체의 배열을 지정합니다. 연결 개체를 얻으려면 Get-SCOMManagementGroupConnection cmdlet을 사용합니다.

이 매개 변수를 지정하지 않으면 cmdlet은 관리 그룹에 대한 활성 영구 연결을 사용합니다. SCSession 매개 변수를 사용하여 다른 영구 연결을 지정합니다. ComputerName 및 자격 증명 매개 변수를 사용하여 관리 그룹에 대한 임시 연결을 만들 수 있습니다. 자세한 내용을 보려면 Get-Help about_OpsMgr_Connections를 입력하십시오.

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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

출력

Microsoft.Unix.Computer[]

이 cmdlet은 성공적으로 설치된 관리되는 UNIX 및 Linux 컴퓨터의 배열을 반환합니다.