次の方法で共有

Update-SCXAgent

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

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

構文

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

説明

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

必要な エージェント パラメーターは、アンインストールする対象の管理対象 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。

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

-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

-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

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

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

Type:CredentialSet
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

-WsManCredential

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

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

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

出力

Microsoft.Unix.Computer[]

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

  • hostname
  • オペレーティング システム
  • 古いエージェントのバージョン
  • 新しいエージェントのバージョン
  • アップグレードの状態
  • [説明]

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

メモ

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