다음을 통해 공유

Invoke-SCXDiscovery

  • 참조
모듈:
OperationsManager

UNIX 및 Linux 컴퓨터의 지정된 구성에 대한 검색 작업을 호출합니다.

구문

Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -Name <String[]>
      -ResourcePool <ManagementServicePool>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]
Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -ResourcePool <ManagementServicePool>
      -IPRange <IPAddress[]>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]

Description

Invoke-SCXDiscovery cmdlet은 UNIX 및 Linux 컴퓨터의 지정된 구성에 대한 검색 작업을 호출합니다.

이 작업은 권한 있는 SSH 설치 작업에 SSH 자격 증명 개체를 사용하고 권한이 낮은 WS-Management 에이전트 통신에는 선택적 Windows PowerShell 자격 증명 개체를 사용합니다. 대상 호스트에 에이전트를 수동으로 설치한 경우 권한이 낮은 WS-Management 자격 증명만 필요합니다.

이 cmdlet의 출력은 검색이 시도된 각 대상 컴퓨터에 대한 검색 결과를 나타내는 DiscoveryResult 개체의 배열입니다.

예제

예제 1: IP 주소 범위 내에서 UNIX 및 Linux 컴퓨터 검색

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key22.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool "pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredential

첫 번째 명령은 Get-Credential cmdlet을 사용하여 사용자에 대한 자격 증명을 가져옵니다. 이 명령은 인증을 요청하는 메시지를 표시한 다음 결과를 $WSCredential 변수에 저장합니다.

두 번째 명령은 Get-SCXSSHCredential cmdlet을 사용하여 사용자에 대한 권한 있는 자격 증명을 만듭니다. 이 명령은 결과를 $SSHCredential 변수에 저장합니다.

세 번째 명령은 Get-SCOMResourcePool cmdlet을 사용하여 pool01이라는 리소스 풀을 가져오고 $Pool 01 변수에 저장합니다.

최종 명령은 IP 주소 범위 내에서 UNIX 및 Linux 컴퓨터를 검색합니다.

예제 2: 비표준 포트를 사용하여 이름으로 UNIX 및 Linux 컴퓨터 검색

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key c:\keys\DavidChew.ppk -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -SSHPort 8022 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredential

첫 번째 명령은 Get-Credential사용하여 사용자에 대한 자격 증명을 가져옵니다. 이 명령은 인증을 요청하는 메시지를 표시한 다음 결과를 $WSCredential 변수에 저장합니다.

두 번째 명령은 Get-SCXSSHCredential사용하여 사용자에 대한 권한 있는 자격 증명을 만듭니다. 이 명령은 결과를 $SSHCredential 변수에 저장합니다.

세 번째 명령은 Get-SCOMResourcePool사용하여 pool01이라는 리소스 풀을 가져온 다음 $Pool 01 변수에 저장합니다.

최종 명령은 리소스 풀을 사용하고 비표준 SSH 포트를 지정하여 이름으로 UNIX 및 Linux 컴퓨터를 검색합니다.

예제 3: 이름으로 UNIX 및 Linux 컴퓨터 검색

PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"

첫 번째 명령은 Get-SCOMResourcePool사용하여 RP1이라는 리소스 풀을 가져온 다음 $Pool 변수에 저장합니다.

두 번째 명령은 관리 에이전트가 이미 설치된 이름으로 UNIX 및 Linux 컴퓨터를 검색합니다.

매개 변수

-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

-IPRange

검색에 사용할 IP 주소 범위를 지정합니다. IPRange 두 개의 IP 주소(예: 192.168.0.1,192.168.0.254)를 포함해야 합니다. IPRange 또는 Name 매개 변수를 지정해야 합니다.

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

-Name

검색에 사용할 유효한 호스트 이름, FQDN 또는 IP 주소(쉼표로 구분) 목록을 지정합니다. IPRange 또는 Name 매개 변수를 지정해야 합니다. 이 매개 변수는 파이프라인에서 허용됩니다.

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

-ResourcePool

서버의 리소스 풀을 지정합니다. 그 중 하나는 현재 관리 서버로 할당되고 다른 하나는 백업 관리 서버로 사용됩니다. 이 매개 변수는 리소스 풀 개체가 필요하며 해당 리소스 풀의 관리 컴퓨터만 반환합니다.

리소스 풀 개체를 가져오는 방법에 대한 자세한 내용은 Get-Help Get-SCOMResourcePool입력합니다.

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

-SCSession

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

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

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

-SshCredential

에이전트 설치 작업을 수행하는 데 사용되는 권한 있는 SSH 자격 증명을 지정합니다. 이 매개 변수를 지정하지 않으면 대상 컴퓨터에 에이전트를 수동으로 설치하지 않으면 검색이 실패합니다.

SSH 자격 증명 개체를 가져오는 방법에 대한 자세한 내용은 Get-Help Get-SCXSSHCredential입력합니다.

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

-SshPort

호스트와의 SSH 통신에 사용할 포트를 지정합니다. 지정하지 않으면 기본값 22가 사용됩니다.

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

-WsManCredential

WS-Management를 통한 낮은 권한의 에이전트 통신에 사용되는 자격 증명을 지정합니다.

User01과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 반환되는 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다. 자세한 내용은 Get-Help Get-Credential입력합니다.

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

출력

DiscoveryResult

이 cmdlet은 검색이 계획된 각 대상 컴퓨터에 대한 검색 결과를 나타내는 DiscoveryResult 개체의 배열을 반환합니다.