Articles

Managing WSUS from Command Line

  • 10/11/2017
  • 10 Minuten Lesedauer
  • B
  • m

このトピックでは次のことを行います。

  • WSUSutil.の目的および機能概要についてまとめます。exe とそのパラメーターについて説明します。
  • 特定のタスクを実行するために使用する構文を提供し定義します。
  • より多くの情報 (たとえば、シナリオ) が利用できる「Microsoft Windows Server Update Services の展開」へのリンク。

WSUSutil.exe

WSUSutil.exe は、コマンド ラインから WSUS サーバーを管理するために使用することができるツールです。 WSUSutil.exeは、WSUSサーバーの%drive%Program FilesUpdate ServicesToolsフォルダーにあります。 次の表にまとめたように、WSUSutil.exeで特定のコマンドを実行して、特定の機能を実行することができます。 WSUSutil.exe を特定のコマンドで実行するための構文は、表のとおりです。

Summary of Commands You Can Use with WSUSutil

コマンド 何ができるか いつ使うか
export エクスポート/インポート処理を構成する二つの部分の最初の部分です。exportコマンドを使用すると、更新メタデータをエクスポートパッケージファイルにエクスポートすることができます。
  • 継続的に、インターネット接続が限られているか制限されているネットワークを実行している場合
import エクスポート/インポート処理を行う2つの部分のうちの2番目。importコマンドは、別のWSUSサーバで作成したエクスポート パッケージ ファイルからサーバに更新メタデータをインポートするコマンドです。 これは、ネットワーク接続を使用せずに、宛先の WSUS サーバーを同期します。
  • 継続的に、接続が限定的または制限されているネットワークを実行している場合
migratesus このコマンドは SUS 1.1 から更新承認を移行するコマンドです。
  • 実装のSUS 1.0からWSUSにアップグレードする場合。
movecontent WSUS サーバがアップデートファイルを格納するファイルシステムの場所を変更します。 また、オプションとして、古い場所から新しい場所に更新ファイルをコピーします
  • Hard drive is full
  • Disk fails
reset データベース内のすべての更新メタデータ行に、ファイルシステム内の更新ファイルに対応して保存してあるかどうかをチェックします。 更新ファイルがないか破損している場合、WSUSは更新ファイルを再度ダウンロードします。
  • WSUSデータベースの復元後
  • トラブルシューティング時
deleteunneededrevisions データベースから不要な更新版に対する更新メタデータをパージします。
  • MSDE が満杯のときにスペースを解放するには
listinactiveapprovals サーバー言語設定の変更により永久にアクティブでない状態にある承認付きの更新タイトルの一覧を返します。
  • 上流サーバー(レプリカサーバーの親)の言語設定を変更し、指定した新しい言語でないためにアクティブでなくなった更新を確認する場合。 このコマンドは、アクティブでない承認の一覧を確認したい場合に実行できます(たとえば、アクティブでない承認を削除するかどうかを決定するのに役立ちます)。 removeinactiveapprovals コマンドを実行する前にこのコマンドを実行する必要はありません。
removeinactiveapprovals WSUS サーバーの言語設定の変更により永久に非アクティブの状態にある更新の承認を削除します。
  • 上流サーバー (レプリカ サーバーの親) で言語設定を変更し、指定した新しい言語でないためにアクティブでなくなった更新を削除したいとき。 このシナリオでは、親サーバーとレプリカサーバーに表示される更新の数の不一致を修正することができます。 このコマンドを実行する前に、listinactiveapprovals コマンドを実行する必要はありません。

エクスポート

更新のエクスポートとインポートに関する背景と手順については、https://go.microsoft.com/fwlink/?linkid=41777のMicrosoft Windows Server Update Servicesの展開の「切断ネットワークの設定(更新プログラムのインポートとエクスポート)」を参照してください。

構文

コマンドライン %drive%Program Files\Update Services, type:

wsusutil export package logfile

パラメータは次の表で定義されています。

パッケージ パッケージのパスとファイル名です。
パラメータ 定義
logfile 作成するログファイルのパスとファイル名.
/help or /? exportコマンドのコマンドラインヘルプを表示します。

#### Import 更新のエクスポートとインポートに関する背景と手順については、https://go.microsoft.com/fwlink/?linkid=41777の「Set Up a Disconnected Network (Import and Export Updates)」を参照してください。 #### Syntax At the command line *%drive%*╱Program Files╱Update Services╱Tools>, type: **wsusutil import** *package* *logfile* パラメーターは次の表で定義されています。 ###

Parameter Definition
package The path and file name of the package .LOGFILE the package .LOGFILE The path and file name of the package .LOGFILE The package .LOGFILE The package .LOGFILE
logfile 作成するログファイルのパスとファイル名.
/help or /? /help or /? Displayes command-line help for import command.

#### Migratesus SUS 1.0 to WSUS migration scenarios and related procedures are extensive covered in the “Migrate from a SUS Server to a WSUS Server” topic in (https://go.microsoft.com/fwlink/?linkid=41777) at https://go.microsoft.com/fwlink/?LinkID=41777.(SWSサーバーをWSUSサーバーへ)…SUS 1.0 への移行シナリオと関連手順は、(https://go.microsoft.com/fwlink/?LinkID=41777) のトピックで広く網羅され ています。 #### Syntax At the command line *%drive%*﹑Program Files﹑Update Services﹑Tools>, type: **wsusutil migratesus** \ \] と入力します。 ###

Parameter Definition
/content contentshare Migrates content from a SUS 1.0, ここで contentshare は SUS 1.0 content のあるフォルダへのパスとします。
/approvals servername Migrates approvals from the SUS 1.0 server, where servername is the name of the SUS 1.0 server.
computergroup Computer Group for which you want to apply the approvals.
/help or /? migratesusパラメータのコマンドラインヘルプを表示します。
/log logfile 移行作業が記録されるファイル。

#### Movecontent このコマンドを実行すると、WSUSutil.exeは次のことを行います。 – 古い場所から新しい場所に更新ファイルをコピーします。 – WSUSデータベースを更新して、更新ファイルの新しい場所を参照するようにします。 更新ファイルの移動先フォルダは、NTFSパーティション上にある必要があります。 コンテンツ移動ツールは、移動先フォルダにすでに更新ファイルが存在する場合は、更新ファイルのコピーを試みません。 WSUSutil.exeは、移動先フォルダに元のフォルダに設定されていたのと同じパーミッションを設定します。

Hinweis

xcopy や Backup ユーティリティ、またはその他の WSUS 固有の方法で、古い場所から新しい場所に更新ファイルをコピーすることができます。 WSUSutil.exe以外の方法でファイルをコピーした場合でも、移動の2番目の部分を実行するためにWSUSutil.exeを実行する必要があります。 この場合、WSUSutil.exe を実行する際に skipcopy パラメータを使用します。 詳細については、以下の「構文」を参照してください。

あるWSUSドライブから別のWSUSドライブに更新ファイルを移動する場合、2つのシナリオがあります。

  • ドライブが一杯の場合
  • ハードディスクが故障した場合

ドライブが一杯の場合

更新ファイルを格納するドライブが一杯になったら、次のいずれかを実行できます。

  • NTFS機能で現在のドライブに領域を追加する。 これは、WSUSutil.exeを使用せずに行います。 この方法は、WSUSの構成や動作に影響を与えません。
  • 新しいドライブをインストールし、Wsusutil.exeを使用して古いドライブから新しい場所に更新ファイルを移動します。

ハードディスクが故障したら

更新ファイルを格納するハードディスクが故障したら、以下を実行しなければなりません:

  1. 新しいディスクをコンピュータ上にインストールして、バックアップファイルから更新ファイルを復元します。 注:更新ファイルをバックアップしていない場合、WSUSutil.exeはコンテンツ移動操作の最後に見つからないファイルをダウンロードします。
  2. 新しいディスクの場所を指定して、コンテンツ移動操作を実行します。 さらに、Backupユーティリティを使用して新しいフォルダにファイルを置くか、ソースフォルダが存在しないため、skipcopyパラメータを指定します。更新ファイルはこのプロセスの最後にダウンロードされます。
  3. 移動オペレーションが完了すると、すべての欠落したファイルがダウンロードされます。

構文

コマンドラインで、*%drive%*Program Files*Appdate ServicesTools>, type:

wsusutil movecontent contentpath logfile -skipcopy

パラメータは次の表に定義されています。

パラメータ 定義
contentpath コンテンツ ファイル用の新しいルートです。 パスは存在しなければなりません。
logfile 作成するログ ファイルのパスとファイル名。
-skipcopy サーバー構成のみを変更し、コンテンツ ファイルをコピーしないことを示します。
/help または /? movecontentコマンドのコマンドラインヘルプを表示します。

#### Reset WSUSサーバーでローカルに更新を保存し、WSUSデータベースに保存されたメタデータ情報が正確であることを確認したい場合、このコマンドを使用します。 このコマンドを使用すると、WSUSデータベースのすべての更新メタデータ行が、WSUSサーバーのローカル更新ファイル格納場所に格納されている更新ファイルに対応していることを確認します。 更新ファイルがない、または破損している場合、WSUS は更新ファイルを再度ダウンロードします。 このコマンドは、データベースを復元した後、または更新承認のトラブルシューティングの最初の手順として実行すると便利な場合があります。 #### Syntax At the command line *%drive%*╱Program Files╱Update Services╱Tools>, type: **Deleteunneededrevisions WSUS実装でMSDEデータベースを使用している場合(Windows 2000を実行しているサーバーでWSUSを使用している場合など)、データベースが2GBの制限に達すると、このコマンドを定期的に実行する必要があることがあります。 更新プログラムは非常に大きく、更新プログラム発行者は通常、各更新プログラムの複数のリビジョンを作成し、サーバーは指定された製品と更新分類に対して自動的に同期するため、通常の使用では、2GBにすぐに到達する可能性があります。 さらに、クライアント コンピュータのイベント情報もデータベースに格納されます。 MSDE データベースが上限に達しそうになると、WSUS コンソールの **Home** ページに、このコマンドをすぐに実行するように警告する通知が表示されます。 このコマンドを実行すると、不要なリビジョンとそのリビジョンに関連するイベントがデータベースから削除されます。 不要なリビジョンとは、少なくとも1ヶ月間コンピュータ グループに展開されていないソフトウェアまたはドライバの更新プログラムのリビジョンです。また、少なくとも1ヶ月間コンピュータ グループに展開されていない期限切れのドライバの更新プログラムの最新リビジョンも含まれます。 この2つのケースにおける1ヶ月という期間は、間接的に変更することが可能です。 このコマンドを実行する過程で、1GBを超えるデータベースのサイズを25%未満に縮小すると、自動的に7~15日短縮されます。 > WSUSで使用できるデータベースの詳細については、https://go.microsoft.com/fwlink/?LinkID=41777の(https://go.microsoft.com/fwlink/?linkid=41777)にある「WSUSに使用するデータベースを選択する」のトピックを参照してください。

Syntax

コマンドライン %drive%Program Files\Update Services\Tools>, type:

wsusutil deleteunneedrevisions

Wichtig

Before running this command, must stop the World Wide Web publishing service in IIS. このコマンドの実行が完了してから、サービスを再起動する必要があります。 IISサービスを停止または開始するには、IISを開き、WSUSがインストールされているWebサイト(デフォルトではデフォルトWebサイト)に移動して右クリックし、[停止]または[開始]をクリックします。

Listinactiveapprovals

アップストリームWSUSサーバーの言語オプションを変更すると、親アップストリームサーバーで承認された更新の数とレプリカサーバーの更新承認数が一致しない状況が発生する可能性があります。

この問題が発生する可能性のあるシナリオを次に示します。

上流の親サーバーを Microsoft Update から同期するように構成し、言語設定をすべての言語 (デフォルト) に設定したままにしました。 その後、同期を実行し、300 件の更新を承認しましたが、そのうち 50 件は英語の更新ではありませんでした。 そこで、サーバーの言語設定を英語のみの設定に変更します。 この後、レプリカサーバーが親アップストリームサーバーから同期を取り、「アクティブな」承認のみをダウンロードします。このとき、英語の承認のみがダウンロードされます(レプリカサーバーは常にアクティブな承認のみを同期させます)。 この時点で、親サーバーのWSUSコンソールを見ると、300件の更新が承認されていることがわかります。 レプリカサーバーで同じことをすると、250件しか承認されていないことがわかります。 親サーバーで永久にアクティブでないアップデートのリストを表示するには、listinactiveapprovals を使用します – この場合、英語でない50個のアップデートが表示されます。 このコマンドは、非アクティブな承認の一覧を表示する場合に実行できます (たとえば、非アクティブな承認を削除するかどうかを決定するのに役立ちます)。 removeinactiveapprovals コマンドを実行する前に、このコマンドを実行する必要はありません。

Syntax

コマンドラインで %drive%Program Files\Update Services, type:

wsusutil listinactiveapprovals

Removeinactiveapprovals

このコマンドが使用するシナリオは、listinactiveapprovalsの説明と同じです。 ただし、親アップストリームサーバー上の非アクティブな承認を一覧表示するにはlistinactiveapprovalsを使用しますが、それらを削除するにはremoveinactiveapprovalsを使用します。 このコマンドを実行する前に、listinactiveapprovals コマンドを実行する必要はありません。

構文

コマンドライン %drive%Program Files\Update Services\Tools>, type:

wsusutil removeinactiveapprovals