次の方法で共有

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>]

説明

Invoke-SCXDiscovery コマンドレットは、UNIX および Linux コンピューターの指定された構成に対して検出操作を呼び出します。

この操作では、特権 SSH インストール アクションに SSH 資格情報オブジェクトを使用し、低い特権 WS-Management エージェント通信用にオプションの Windows PowerShell 資格情報オブジェクトを使用します。 エージェントがターゲット ホストに手動でインストールされている場合は、低い特権の WS-Management 資格情報のみが必要です。

このコマンドレットの出力は、探索 対象の各コンピューターの検出結果を表す 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 コマンドレットを使用してユーザーの資格情報を取得します。 コマンドによって認証のプロンプトが表示され、結果が $WSCredential 変数に格納されます。

2 番目のコマンドは、Get-SCXSSHCredential コマンドレットを使用して、ユーザーの特権資格情報を作成します。 このコマンドは、結果を $SSHCredential 変数に格納します。

3 番目のコマンドは、Get-SCOMResourcePool コマンドレットを使用して 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 変数に格納されます。

2 番目のコマンドは、Get-SCXSSHCredentialを使用して、ユーザーの特権資格情報 作成します。 このコマンドは、結果を $SSHCredential 変数に格納します。

3 番目のコマンドは、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変数に格納します。

2 番目のコマンドは、管理エージェントが既にインストールされている名前で UNIX および Linux コンピューターを検出します。

パラメーター

-ComputerName

コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。

System Center Data Access サービスは、コンピューター上でアクティブである必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

管理グループ接続を実行するユーザー アカウントを指定します。 Get-Credential コマンドレットから返されるオブジェクトなど、PSCredential オブジェクトをこのパラメーターに指定します。 資格情報オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。

ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IPRange

検出に使用する IP アドレスの範囲を指定します。 IPRange には、2 つの IP アドレス (192.168.0.1,192.168.0.254 など) が含まれている必要があります。 IPRange または Name パラメーターを指定する必要があります。

型:IPAddress[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

検出に使用する有効なホスト名、FQDN、または IP アドレスの一覧 (コンマで区切る) を指定します。 IPRange または Name パラメーターを指定する必要があります。 このパラメーターはパイプラインから受け入れられます。

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourcePool

サーバーのリソース プールを指定します。そのうちの 1 つは現在の管理サーバーに割り当てられ、その他はバックアップ管理サーバーとして機能します。 このパラメーターにはリソース プール オブジェクトが必要であり、そのリソース プール内のマネージド コンピューターのみが返されます。

リソース プール オブジェクトを取得する方法については、「Get-Help Get-SCOMResourcePool」と入力します。

型:ManagementServicePool
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SCSession

Connection オブジェクトの配列 指定します。 Connection オブジェクト 取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。

このパラメーターを指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細については、「Get-Help about_OpsMgr_Connections」と入力します。

型:Connection[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SshCredential

エージェントのインストール 操作を実行するために使用する特権 SSH 資格情報を指定します。 このパラメーターを指定しない場合、対象のコンピューターにエージェントが手動でインストールされていない限り、検出は失敗します。

SSH 資格情報オブジェクトを取得する方法については、「Get-Help Get-SCXSSHCredential」と入力します。

型:CredentialSet
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SshPort

ホストとの SSH 通信に使用するポートを指定します。 指定しない場合は、既定値の 22 が使用されます。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WsManCredential

WS-Management を介した低い特権のエージェント通信に使用される資格情報を指定します。

User01 などのユーザー名を入力するか、PSCredential オブジェクト (Get-Credential コマンドレットによって返されるオブジェクトなど) を入力します。 ユーザー名を入力すると、パスワードの入力を求められます。 詳細については、「Get-Help Get-Credential」と入力します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

DiscoveryResult

このコマンドレットは、探索が計画された対象の各コンピューターの検出結果を表す DiscoveryResult オブジェクトの配列を返します。