次の方法で共有

Install-SCXAgent

  • リファレンス
モジュール:
OperationsManager

検出された UNIX および Linux コンピューターの Operations Manager エージェントをインストールします。

構文

Install-SCXAgent
       -DiscoveryResult <DiscoveryResult[]>
       [-SCSession <Connection[]>]
       [-ComputerName <String[]>]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Install-SCXAgent コマンドレットは、検出された UNIX および Linux コンピューター用の Operations Manager エージェントをインストールし、WS-Management通信用の証明書に署名し、管理のために Operations Manager にエージェントを登録します。 UNIX および Linux コンピューターは、Invoke-SCXDiscovery コマンドレットを使用して検出する必要があります。 Invoke-SCXDiscovery コマンドレットの出力オブジェクトは、Install-SCXAgent コマンドレットの DiscoveryResult 入力として提供されます。

UNIX または Linux コンピューターの検出の詳細については、「Invoke-SCXDiscovery」Get-Help入力します。

このコマンドレットは、正常にインストールされたターゲット システムを表すマネージド 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 コマンドレットを使用してユーザーの資格情報を取得します。 コマンドによって認証を求められた後、結果が $WSCredential 変数に格納されます。

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

3 番目のコマンドは、Get-SCOMResourcePool コマンドレットを使用して Pool01 という名前のリソース プールを取得し、$Pool 01 変数に格納します。

最後のコマンドは、Invoke-SCXDiscovery コマンドレットを使用して、IP アドレスの範囲内にある 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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-DiscoveryResult

Invoke-SCXDiscovery コマンドレットによって返される管理エージェントのインストールを処理する 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 コマンドレットを使用します。

このパラメーターが指定されていない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

出力

Microsoft.Unix.Computer[]

このコマンドレットは、正常にインストールされたマネージド UNIX および Linux コンピューターの配列を返します。