Configuration Manager のサービス接続ツールを使用する
Configuration Manager (現在のブランチ) に適用
サービス接続ポイントがオフライン モードの場合は、サービス接続ツールを使用します。 Configuration Manager サイト システム サーバーがインターネットに接続されていない場合にも使用できます。 このツールを使用すると、Configuration Manager の最新の更新プログラムを使用してサイトを最新の状態に保つことができます。
ツールを実行すると、Configuration Manager クラウド サービスに接続し、階層の使用状況情報をアップロードし、更新プログラムをダウンロードします。 クラウド サービスが環境に適切な更新プログラムを提供できるようにするには、使用状況データをアップロードする必要があります。
前提条件
サイトにはサービス接続ポイントがあり、 オフラインのオンデマンド接続用に構成します。
管理者としてコマンド プロンプトからツールを実行します。 ユーザー インターフェイスはありません。
サービス接続ポイントとインターネットに接続できるコンピューターからツールを実行します。 これらの各コンピューターには x64 ビット OS があり、次のコンポーネントが必要です。
Visual C++ 再頒布可能 x86 ファイルと x64 ファイルの両方。 既定では、Configuration Manager は、サービス接続ポイントをホストするコンピューターに x64 バージョンをインストールします。 このツールには、Microsoft Visual C++ 2015-2019 再頒布可能パッケージ (14.28.29914.0) 以降が、実行元のコンピューターに必要です。 このコンポーネントをダウンロードするには、「 Microsoft Visual C++ 再頒布可能な最新のサポートされているダウンロード」を参照してください。
注:
2107 より前のサポート対象外バージョンの Configuration Manager からアップグレードする場合、ツールには、同じ リンクから使用できる Visual C++ 2013 再頒布パッケージ (12.0.40660.0) が必要です。
このツールには .NET バージョン 4.6.2 が必要であり、バージョン 4.8 が推奨されます。 詳細については、「 サイトとサイト システムの前提条件」を参照してください。
バージョン 2309 以降では、このツールには ODBC Driver 18 for SQL Server (x64) のインストールが必要です。 このコンポーネントをダウンロードするには、「 ODBC Driver for SQL Server のダウンロード」を参照してください。
ツールの実行に使用するアカウントには、次のアクセス許可が必要です。
サービス接続ポイントをホストするコンピューターのローカル管理者
サイト データベースに対する読み取りアクセス許可
インターネット にアクセスできるコンピューターとサービス接続ポイントの間でファイルを転送する方法が必要です。 たとえば、ファイルと更新プログラムを格納するのに十分な空き領域を備えた USB ドライブなどです。
概要
準備: サービス接続ポイントでツールを実行します。 指定した場所にある .cab ファイルに使用状況データが格納されます。 インターネットに接続したコンピューターにデータ ファイルをコピーします。
接続: インターネットに接続したコンピューターでツールを実行します。 使用状況データがアップロードされ、Configuration Manager の更新プログラムがダウンロードされます。 ダウンロードした更新プログラムをサービス接続ポイントにコピーします。
一度に複数のデータ ファイルをアップロードできます。それぞれ異なる階層からアップロードできます。 プロキシ サーバーとプロキシ サーバーのユーザーを指定することもできます。
インポート: サービス接続ポイントでツールを実行します。 更新プログラムがインポートされ、サイトに追加されます。 その後、Configuration Manager コンソールで これらの更新プログラム を表示してインストールできます。
複数のデータ ファイルをアップロードする
エクスポートされたすべてのデータ ファイルを別々の階層から同じフォルダーに配置します。 各ファイルに一意の名前を付けます。 必要に応じて、手動で名前を変更できます。
ツールを実行して Microsoft にデータをアップロードする場合は、データ ファイルを含むフォルダーを指定します。
ツールを実行してデータをインポートすると、ツールはその階層のデータのみをインポートします。
プロキシ サーバーを指定する
インターネット接続を持つコンピューターにプロキシ サーバーが必要な場合、このツールは基本的なプロキシ構成をサポートします。 省略可能なパラメーター -proxyserveruri と -proxyusername を使用します。 詳細については、「 コマンド ライン パラメーター」を参照してください。
ダウンロードする更新プログラムの種類を指定する
このツールでは、ダウンロードするファイルを制御するためのオプションがサポートされています。 既定では、ツールは、サイトのバージョンに適用される利用可能な最新の更新プログラムのみをダウンロードします。 修正プログラムはダウンロードされません。
この動作を変更するには、次のいずれかのパラメーターを使用して、ダウンロードするファイルを変更します。
-downloadall: サイトのバージョンに関係なく、更新プログラムや修正プログラムを含むすべての更新プログラムをダウンロードします。
-downloadhotfix: サイトのバージョンに関係なく、すべての修正プログラムをダウンロードします。
-downloadsiteversion: サイトのバージョンより新しいバージョンの更新プログラムと修正プログラムをダウンロードします。
重要
Configuration Manager バージョン 2002 の既知の問題のため、既定の動作は期待どおりに機能しません。 バージョン 2006 に更新するか、 -downloadsiteversion パラメーターを使用してバージョン 2002 に必要な更新プログラムをダウンロードします。
詳細については、「 コマンド ライン パラメーター」を参照してください。
ヒント
このツールは、データ ファイルからサイトのバージョンを決定します。 バージョンを確認するには、サイトのバージョンでという名前のテキスト ファイルの .cab ファイルを調べてみます。
ツールを使用する
サービス接続ツールは、Configuration Manager インストール メディア内のパス: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exeです。 使用する Configuration Manager のバージョンと一致するサービス接続ツールを常に使用します。 サービス接続ツールを機能させるには、これらのファイルはすべて同じフォルダーに存在する必要があります。
すべてのコンテンツを含む ServiceConnectionTool フォルダーを、インターネット接続のあるコンピューターにコピーします。
この手順では、コマンド ラインの例では、次のファイル名とフォルダーの場所を使用します。 これらのパスとファイル名を使用する必要はありません。 環境と設定に合った代替手段を使用できます。
サービス接続ポイント上の Configuration Manager インストール メディア ソース ファイルへのパス:
C:\Sourceコンピューター間で転送するデータを格納する USB ドライブへのパス:
D:\USB\サイトからエクスポートするデータ ファイルの名前:
UsageData.cabツールが Configuration Manager のダウンロードした更新プログラムを格納する空のフォルダーの名前。
UpdatePacks
準備
サービス接続ポイントをホストするコンピューターで、管理者としてコマンド プロンプトを開き、ディレクトリをツールの場所に変更します。 例:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\次のコマンドを実行して、データ ファイルを準備します。
ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab注:
複数の階層から同時にデータ ファイルをアップロードする場合は、各データ ファイルに一意の名前を付けます。 必要に応じて、後でファイルの名前を変更できます。
ファイル内のデータは、サイト用に構成した診断データと使用状況データのレベルに基づいています。 詳細については、「 診断データと使用状況データの概要」を参照してください。 このツールを使用して、データを CSV ファイルにエクスポートして内容を表示できます。 詳細については、「 -export」を参照してください。
ツールが使用状況データのエクスポートを完了したら、インターネットにアクセスできるコンピューターにデータ ファイルをコピーします。
接続
インターネット にアクセスできるコンピューターで、管理者としてコマンド プロンプトを開き、ディレクトリをツールの場所に変更します。 この場所は、 ServiceConnectionTool フォルダー全体のコピーです。 例:
cd D:\USB\ServiceConnectionTool\次のコマンドを実行してデータ ファイルをアップロードし、Configuration Manager の更新プログラムをダウンロードします。
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacksその他の例については、「 コマンド ライン パラメーター」を参照してください。
注:
このコマンド ラインを実行すると、次のエラーが表示されることがあります。
未処理の例外: System.UnauthorizedAccessException: パス 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' へのアクセスが拒否されました。
このエラーは無視しても問題ありません。 続行するには、エラー ウィンドウを閉じます。
ツールが更新プログラムのダウンロードを完了したら、それらをサービス接続ポイントにコピーします。
インポート
サービス接続ポイントをホストするコンピューターで、管理者としてコマンド プロンプトを開き、ディレクトリをツールの場所に変更します。 例:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\次のコマンドを実行して、更新プログラムをインポートします。
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacksインポートが完了したら、コマンド プロンプトを閉じます。 該当する階層の更新プログラムのみがインポートされます。
Configuration Manager コンソールで、[ 管理 ] ワークスペースに移動し、[ 更新とサービス ] ノードを選択します。 インポートされた更新プログラムをインストールできるようになりました。 詳細については、「 コンソール内の更新プログラムをインストールする」を参照してください。
ログ ファイル
ServiceConnectionTool.log: サービス接続ツールを実行するたびに、このログ ファイルに書き込まれます。 ログ ファイルのパスは、常にツールと同じ場所です。 このログ ファイルは、使用するパラメーターに基づいて、ツールの使用状況に関する簡単な詳細を提供します。 ツールを実行するたびに、ツールは既存のログ ファイルを置き換えます。
ConfigMgrSetup.log: 接続 フェーズ中に、ツールはシステム ドライブのルートにあるこのログ ファイルに書き込みます。 このログ ファイルは、より詳細な情報を提供します。 たとえば、ツールがダウンロードするファイルや、ハッシュ チェックが成功した場合などです。
コマンド ライン パラメーター
このセクションでは、サービス接続ツールで使用可能なすべてのパラメーターをアルファベット順に一覧表示します。
-繋ぐ
インターネット にアクセスできるコンピューターの [接続 ] フェーズで使用します。 Configuration Manager クラウド サービスに接続してデータ ファイルをアップロードし、更新プログラムをダウンロードします。
次のパラメーターが必要です。
- -usagedatasrc: アップロードするデータ ファイルの場所
- -updatepackdest: ダウンロードした更新プログラムのパス
次の省略可能なパラメーターを使用することもできます。
- -proxyserveruri: プロキシ サーバーの FQDN
- -proxyusername: プロキシ サーバーのユーザー名
- -downloadall: サイトのバージョンに関係なく、更新プログラムや修正プログラムを含むすべてのものをダウンロードします。
- -downloadhotfix: サイトのバージョンに関係なく、すべての修正プログラムをダウンロードします。
- -downloadsiteversion: サイトのバージョンより新しいバージョンの更新プログラムと修正プログラムをダウンロードします。
プロキシ サーバーを使用しない接続の例
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks
プロキシ サーバーとの接続の例
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic
サイト バージョンの適用可能な更新プログラムのみをダウンロードするための接続の例
ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks
-dest
エクスポートする CSV ファイルのパスとファイル名を指定するために、 -export パラメーターを使用して必要なパラメーター。 詳細については、「 -export」を参照してください。
-downloadall
サイトのバージョンに関係なく、更新プログラムや修正プログラムなど、すべてをダウンロードするための -connect パラメーターを持つ省略可能なパラメーター。 詳細については、「 -connect」を参照してください。
-downloadhotfix
サイトのバージョンに関係なく、すべての修正プログラムのみをダウンロードするための -connect パラメーターを持つ省略可能なパラメーター。 詳細については、「 -connect」を参照してください。
-downloadsiteversion
サイトのバージョンより新しいバージョンの更新プログラムと修正プログラムのみをダウンロードする -connect パラメーターを持つ省略可能なパラメーター。 詳細については、「 -connect」を参照してください。
-輸出
[ 準備 ] フェーズで使用して、使用状況データを CSV ファイルにエクスポートします。 サービス接続ポイントで管理者として実行します。 このアクションを使用すると、Microsoft にアップロードする前に使用状況データの内容を確認できます。 CSV ファイルの場所を指定するには、 -dest パラメーターが必要です。
エクスポートの例
-export -dest D:\USB\usagedata.csv
-輸入
サービス接続ポイントの [インポート ] フェーズで、更新プログラムをサイトにインポートする場合に使用します。 ダウンロードした更新プログラムの場所を指定するには、 -updatepacksrc パラメーターが必要です。
インポートの例
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
-準備する
サービス接続ポイントの 準備 フェーズで使用して、サイトから使用状況データをエクスポートします。 エクスポートされたデータ ファイルの場所を指定するには、 -usagedatadest パラメーターが必要です。
準備の例
ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab
-proxyserveruri
プロキシ サーバーの FQDN を指定する -connect パラメーターを持つ省略可能なパラメーター。 詳細については、「 -connect」を参照してください。
-proxyusername
プロキシ サーバーで認証するユーザー名を指定する -connect パラメーターを持つ省略可能なパラメーター。 詳細については、「 -connect」を参照してください。
-updatepackdest
ダウンロードした更新プログラムのパスを指定するために 、-connect パラメーターを使用して必要なパラメーター。 詳細については、「 -connect」を参照してください。
-updatepacksrc
ダウンロードした更新プログラムのパスを指定するために 、-import パラメーターを使用して必要なパラメーター。 詳細については、「 -import」を参照してください。
-usagedatadest
エクスポートされたデータ ファイルのパスとファイル名を指定するために、 -prepare パラメーターを持つ必須パラメーター。 詳細については、「 -prepare」を参照してください。