次の方法で共有

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

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

-Credential

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

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

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

-IPRange

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

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

-Name

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

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

-ResourcePool

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

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

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

-SCSession

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

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

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

-SshCredential

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

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

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

-SshPort

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

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

-WsManCredential

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

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

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

出力

DiscoveryResult

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