次の方法で共有

Update-SCXAgent

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

指定した UNIX および Linux コンピューター上の管理エージェントを、使用可能な最新バージョンにアップグレードします。

構文

Update-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-SCXAgent コマンドレットは、指定されたコンピューター上のエージェントを使用可能な最新バージョンに更新します。 使用可能な最新バージョンの管理エージェントが既に対象のコンピューターをインストールしている場合、何も行われません。

必須の Agent パラメーターは、アンインストールする対象の管理対象 UNIX および Linux コンピューターを指定し、UNIX および Linux コンピューター オブジェクトを必要とします。 管理対象 UNIX および Linux コンピューターの取得については、Get-SCXAgent コマンドレットを参照してください。 このコマンドレットは、SshCredential を受け入れ、WsManCredential 入力パラメーターを します。 指定した SshCredential パラメーターは特権エージェントの更新アクションに使用され、指定された WsManCredential は低特権エージェント通信に使用されます。 SshCredential パラメーターが指定されていない場合、コマンドレットは、対象のコンピューターに関連付けられている定義済みのエージェント メンテナンス実行アカウントの使用を試みます。

このコマンドレットの出力は、正常に更新されたターゲット システムを表す管理対象 UNIX または Linux コンピューター オブジェクトの配列です。

例

例 1: 管理エージェントを更新する

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -Agent $Agent01

最初のコマンドは、Get-SCXAgent コマンドレットを使用して、nx1.contoso.com という名前のマネージド Linux または UNIX コンピューターのエージェントを取得します。 このコマンドは、$Agent 01 変数に格納します。

2 番目のコマンドは、Get-Credential コマンドレットを使用してユーザーの資格情報を取得します。 コマンドによって認証のプロンプトが表示され、結果が $WSCredential 変数に格納されます。

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

最後のコマンドは、$Agent 01 の管理エージェントを 2 番目と 3 番目のコマンドの値で更新します。

例 2: 定義された実行アカウントを使用して管理エージェントを更新する

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent

このコマンドは、get-SCXAgentを使用して、nx1.contoso.com という名前のマネージド Linux または UNIX コンピューター エージェントを取得します。 このコマンドは、マネージド コンピューターを現在のコマンドレットに渡します。 このコマンドは、定義された実行アカウントを使用して管理エージェントを更新します。

パラメーター

-Agent

1 つ以上の管理対象 UNIX または Linux コンピューター オブジェクトを指定します。 マネージド UNIX または Linux コンピューター オブジェクトを取得する方法については、「Get-Help Get-SCXAgent」と入力します。

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

-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

-SCSession

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

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

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

-SshCredential

エージェントの更新アクションを実行するために使用する特権 SshCredential パラメーターを指定します。 このパラメーターが指定されていない場合、コマンドレットは、エージェントの定義済みのエージェント メンテナンス実行アカウントの使用を試みます。

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

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

-WsManCredential

WSMan を介した低い特権のエージェント通信に使用される資格情報を指定します。 このコマンドレットでは、この資格情報を使用してエージェントの可用性を確認します。

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

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

出力

Microsoft.Unix.Computer[]

このコマンドレットは、コンピューターのアップグレード状態を表すアップグレード結果のコレクションを返します。 各結果には、次の情報が含まれている必要があります。

  • ホスト名
  • オペレーティング システム
  • 古いエージェントのバージョン
  • 新しいエージェントのバージョン
  • アップグレードの状態
  • 形容

説明には、アップグレードが失敗した理由の詳細が含まれています。

メモ

  • このコマンドレットは、列挙された方法でホスト名のコレクションを受け取ります。 すべてのホスト名が収集され、パイプラインの最後でコレクション全体が並列に処理されます。