Install-SCXAgent
検出された 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 サービスは、コンピューター上でアクティブである必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。
Get-Credential コマンドレットから返されるオブジェクトなど、PSCredential オブジェクトをこのパラメーターに指定します。
資格情報オブジェクトの詳細については、「Get-Help Get-Credential
」と入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DiscoveryResult
対象システムの検出の詳細については、「Get-Help Invoke-SCXDiscovery
」と入力します。
型: | DiscoveryResult[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
このパラメーターを指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続的な接続を指定します。
ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細については、「Get-Help about_OpsMgr_Connections
」と入力します。
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
Microsoft.Unix.Computer[]
このコマンドレットは、正常にインストールされた管理対象 UNIX および Linux コンピューターの配列を返します。