Configuration Manager の管理サービスとは何ですか?

Configuration Manager (現在のブランチ) に適用

SMS プロバイダーは、管理サービスと呼ばれる HTTPS 経由で API 相互運用性アクセスを提供します。 管理サービスは、オープン データ (OData) v4 プロトコルに基づく Representational State Transfer (REST) API です。

現在、管理サービスには 2 つのレイヤーまたはルートがあります。

  • 管理サービス > WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    WMI ルートでは、700 を超えるクラスへの GET コマンドと POST コマンドの両方がサポートされます。

  • OData/SQL > 管理サービス: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    このバージョン固定ルート (v1.0) は、新しい Configuration Manager 機能をサポートしています。

<ClassName>値は有効な Configuration Manager クラス名です。 管理サービス・クラス名は大文字と小文字が区別されます。 適切な大文字と小文字を使用するようにしてください。 たとえば、「 SMS_Site 」のように入力します。

シナリオ

Configuration Manager は、次の機能に管理サービスをネイティブで使用します。

さらに、管理サービスを使用して次のようなカスタム ソリューションを開発できます。

  • カスタム Web サービスを置き換えて、サイトから情報にアクセスします。

  • Configuration Manager コンソールから直接実行する PowerShell スクリプト。 詳細については、「Configuration Manager コンソールから PowerShell スクリプトを作成して実行する」を参照してください。

  • タスク シーケンスの PowerShell スクリプト。 この操作により、WMI プロバイダーとインターフェイスするためのカスタム Web サービスを必要とせずに、サイトの情報にアクセスできます。 詳細については、「 タスク シーケンスの手順 - PowerShell スクリプトの実行」を参照してください。

  • OData コネクタ オプションを使用して、Power BI からサイト データにアクセスします。

前提条件

SMS プロバイダーの役割をホストするサーバーで、次の前提条件を構成します。

  • 2006 以前のバージョンでは、Windows サーバーの役割 Web サーバー (IIS) を有効にします。 バージョン 2010 以降では、この役割は不要になりました。

  • バージョン 2107 以降、SMS プロバイダーには .NET バージョン 4.6.2 が必要であり、バージョン 4.8 を推奨します。 バージョン 2103 以前では、この役割には .NET 4.5 以降が必要です。 詳細については、 サイトとサイト システムの前提条件

  • 信頼できる証明書を使用して、セキュリティで保護された HTTPS 通信を有効にすることが必要な場合があります。 詳細については、「 安全な HTTPS 通信を有効にする」を参照してください。

管理サービスにアクセスするには、ユーザー アカウントが Configuration Manager の管理者ユーザーである必要があります。 クラウド管理ゲートウェイ経由で管理サービスにアクセスする場合は、Microsoft Entra ID にアカウントが必要です。

SMS プロバイダーと管理サービスのスケーラビリティの詳細については、「 サイズとスケール番号」を参照してください。

注:

Configuration Manager コンソールを備えたコンピューターでプロキシ サーバーを使用している場合、コンソールは管理サービスへの接続に失敗します。 たとえば、 セキュリティ ノードにアクセスしようとすると、管理サービスが有効ではない、または使用できないというエラーが表示される場合があります。 SmsAdminUI.log ファイルには、次のようなエラーが表示されます。Failed to get a response for OData query.

この問題を回避するには、コンピューターからプロキシ構成を削除するか、次の構成変更を行います。

  1. 次の XML ファイルを手動で編集します。 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. 次のいずれかのオプションを使用して <defaultproxy> 動作を構成します。

    1. Set enabled="false"
    2. SMS プロバイダーの FQDN を <bypasslist>に追加します。

    詳細については、「 <defaultProxy> Element (ネットワーク設定)」を参照してください。

次の手順