エンタープライズ管理設定の構成

サーバーマネージド、MDM マネージド、またはファイルベースの展開を使用して、エンタープライズ全体 Copilot クライアントの動作を一元的に制御するようにエンタープライズ管理設定を構成します。

この機能を使用できるユーザーについて

Enterprise owners

この記事で

エンタープライズ管理設定を使用すると、エンタープライズ所有者は、企業のCopilot CLI (コパイロット CLI)プランのユーザーに対して構成設定を一元的に定義してVS CodeおよびCopilotに配布し、すべてのメンバーが同じガードレール内で動作することを保証できます。 追加のクライアント サポートが続きます。

これらの設定は、組織全体に適用され、組織レベルのオーバーライドはありません。 サポートされているキーごとに、 managed-settings.json 値は、ユーザーがクライアントで設定するファイル ベースの構成よりも優先されます。

マネージド設定は、デバイスにネットワーク接続がない場合でも、クライアントの起動時にローカルに読み込まれます。 つまり、無効なバイパス モードや制限付きプラグイン構成などのコントロールは、サインインまたはサーバーラウンドトリップの前に引き続き適用され、ユーザーがアカウントを切り替えたときにアクティブなままです。

デプロイ方法の選択

エンタープライズ管理設定を展開するには、複数の方法があります。 適切な方法を選択するには、次のガイドラインに従います。 どのような方法でも、広範な展開を行う前に、小さなデバイス グループをパイロットします。

  • サーバー管理: ほとんどの企業の既定値で、ワークフローと監査履歴の確認に最適
  • MDM マネージド: IT チームが macOS および Windows 上の既存の MDM ツールを使用してデバイス グループ ターゲットを設定する必要がある場合に最適
  • ファイルベース: すべてのプラットフォームで使用でき、コンテナーや MDM などの開発者環境を含め、サーバーで管理され、MDM で管理される展開が使用できない場合に便利です Codespaces

サーバー管理設定の展開

  1. .github-private リポジトリを作成して構成します。 「.github-private リポジトリの作成」を参照してください。
  2. リポジトリで、 copilot/managed-settings.jsonを作成または更新します。
  3. エンタープライズ ポリシー キーと値を JSON 形式で追加します。
  4. 変更をコミットして既定のブランチにプッシュします。
  5. エンタープライズ ユーザーがサポートされているクライアントを実行していることを確認します。 更新された設定は、約 1 時間以内、またはクライアントの再起動またはユーザーが再びサインインした直後に自動的に適用されます。

MDM で管理される設定の展開

  1. サーバーで管理される設定に使用されるのと同じ JSON スキーマを使用して、 managed-settings.json ペイロードを作成または更新します。

  2. エンタープライズ MDM プラットフォームと標準のロールアウト プロセスを使用してペイロードをデプロイします。

  3. ポリシーをターゲット デバイス グループに割り当てます。

    クライアントは再起動する必要はありません。また、更新されたポリシーを時間単位で確認する必要はありません。 VS Codeでは、管理者は Developer: Sync Account Policy コマンドを実行してテストのチェックを強制できます。

  4. 設定が有効であることを確認します。 構成が適用されたことを確認するを参照してください。

ファイル ベースの設定の展開

  1. 適用するポリシー キーと値を使用して、 managed-settings.json ファイルを作成または更新します。
  2. 標準のデバイス管理プロセスを使用して、マネージド マシンにファイルを配布します。 ファイルを受信しないマシンは、このポリシーによって制限されないため、ファイル ベースの展開では、アクティブに配布するマシンに対してのみ対象範囲が提供されます。
  3. エンタープライズ セキュリティ要件に従ってファイルのアクセス許可を適用します。
  4. 更新されたポリシーが起動時に読み込まれるように、サポートされているクライアントを再起動するようユーザーに依頼します。
  5. 設定が有効であることを確認します。 構成が適用されたことを確認するを参照してください。

統合スキーマ リファレンス

managed-settings.json ファイルでは、次の最上位のプロパティがサポートされています。 適用する設定に基づいて、これらのプロパティの任意の組み合わせを含めることができます。

JSON
{
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  },
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  },
  "model": "auto"
}
  • extraKnownMarketplaces: ユーザーが使用できる追加のプラグイン マーケットプレースを定義します。 各エントリは、プロバイダー (source) とリポジトリを"github"形式で指定するOWNER/REPO プロパティを含む名前付き Marketplace オブジェクトです。
  • strictKnownMarketplaces: プラグインのインストールを、企業によって明示的に定義されたマーケットプレースのみに制限します。 各エントリは、 source プロパティを含む Marketplace オブジェクトです。 sourceは、"github"形式のrepoを持つOWNER/REPO、または git リポジトリを指す"git"を持つurlとしてプロバイダーを指定します。
  • enabledPlugins: すべてのエンタープライズ ユーザーに対して自動的にインストールされるプラグインを定義します。 各エントリでは、 PLUGIN-NAME@MARKETPLACE-NAME 形式がキーとして使用され、プラグインを有効にするためにブール値が true されます。
  • permissions: ユーザーがコマンド承認をバイパスできるかどうかを制御します。 disableBypassPermissionsModeを "disable" に設定して、ユーザーがバイパス モードをオンにできないようにします。 詳細については、この記事の 「企業のバイパス モードの無効化 」を参照してください。
  • model: 既定のモデル ガバナンス設定を制御します。 新しい会話が既定で Copilot の自動モデル選択で開始されるように、"auto" に設定します。 ユーザーは、会話ごとに別のモデルに切り替えることができます。

エンタープライズ プラグイン標準の構成

設定を適用して、ユーザーが利用できるプラグイン マーケットプレースと既定でインストールされているプラグインを制御できます。 「エンタープライズで管理されるプラグインの標準について」を参照してください。

  1. 推奨される展開方法を使用して、エンタープライズ管理設定ファイルを作成または更新します。 デプロイ方法の比較については、 エンタープライズ管理設定の構成 を参照してください。

.github-private リポジトリでのサーバー管理デプロイの場合は、copilot/managed-settings.jsonにファイルを作成します。 レガシ パス (.github/copilot/settings.json) もサポートされています。

  1. 必要な extraKnownMarketplaces、 strictKnownMarketplaces、および enabledPlugins プロパティをファイルに追加します。 統合スキーマ リファレンスの例とプロパティの説明を参照してください。 これらのプロパティを上書きするのではなく既存のファイルにマージするため、 permissionsなどの他のポリシー用に構成された設定は削除されません。

    JSON
    {
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true
  }
}

  2. 変更をコミットして、 .github-private リポジトリの既定のブランチにプッシュします。

自動モデル選択 Copilot 既定値として設定する

Copilot CLI (コパイロット CLI)とVS Codeで、自動モデル選択を新しい会話の既定のモデルとして設定できます。 詳細については、 AUTOTITLE を参照してください。 これを企業の既定値として設定することで、新しい会話が [自動モデル] が選択された状態で開始されるようにします。

自動モデルを既定値として設定する方法

modelに"auto"すると、両方のクライアントで [自動モデル] が選択された状態で新しい会話が開始されます。

  • Copilot CLI (コパイロット CLI)では、ユーザーが別のモデルを指定しない限り、新しいセッションでは自動モデルが使用されます。
  • VS Codeでは、ユーザーが新しい会話を開始すると、モデル ピッカーは既定で [自動モデル] に設定されます。

ユーザーは、会話ごとに別のモデルに切り替えることができます。

設定の構成

  1. 推奨される展開方法を使用して、エンタープライズ管理設定ファイルを作成または更新します。 デプロイ方法の比較については、 エンタープライズ管理設定の構成 を参照してください。

.github-private リポジトリでのサーバー管理デプロイの場合は、copilot/managed-settings.jsonにファイルを作成します。 レガシ パス (.github/copilot/settings.json) もサポートされています。

  1. model プロパティをファイルに追加し、"auto"に設定します。

    JSON
    {
  "model": "auto"
}

組織のバイパス モードを無効にする

ユーザーが Copilot CLI (コパイロット CLI) および VS Codeでバイパス モード ("YOLO モード" とも呼ばれます) を有効にできないようにすることができます。 バイパス モードを使用すると、エージェントは承認を求めずにコマンドの実行、ファイルへのアクセス、URL のフェッチを行うことができます。 企業で無効にすることで、ユーザーがこれらの各アクションを確実にレビューできるようになります。

バイパスモードを無効にすることで防止されること

disableBypassPermissionsModeを "disable" に設定すると、ユーザーはどちらのクライアントでもバイパス モードを有効にできません。

  • Copilot CLI (コパイロット CLI)では、--yolo、--allow-all、--allow-all-tools、--allow-all-paths、および--allow-all-urlsのコマンド ライン オプションと、/yoloおよび/allow-allスラッシュ コマンドがブロックされます。
  • VS Codeでは、"YOLO モード" とも呼ばれるグローバル自動承認設定 (chat.tools.global.autoApprove) はオフになり、再度有効にすることはできません。

設定の構成

  1. 推奨される展開方法を使用して、エンタープライズ管理設定ファイルを作成または更新します。 デプロイ方法の比較については、 エンタープライズ管理設定の構成 を参照してください。

.github-private リポジトリでのサーバー管理デプロイの場合は、copilot/managed-settings.jsonにファイルを作成します。 レガシ パス (.github/copilot/settings.json) もサポートされています。

  1. permissionsプロパティをファイルに追加し、disableBypassPermissionsModeを "disable" に設定します。 ファイルに既に permissions オブジェクトがある場合 (たとえば、他のアクセス許可設定から)、オブジェクトを置き換えるのではなく、このキーをマージします。

    JSON
    {
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

構成が適用されたことを確認する

構成がコミットされると、クライアントは定期的にサーバーで更新された構成を確認するため、サポートされているクライアントのユーザーは約 1 時間以内に指定された設定を確認します。 クライアントを再起動するか、もう一度サインインすると、最新の設定がすぐに適用されます。

ユーザーにこれらの設定が表示されない場合は、企業またはその組織のいずれかを通じて Copilot へのアクセス権をユーザーが受け取っていることを確認します。 ユーザーが複数の課金エンティティからライセンスを受け取った場合は、 個人の Copilot 設定の [使用量の請求先] ドロップダウンで企業を選択していることを確認します。