Überschreiben von unternehmensverwalteten Einstellungen für Unternehmensteams

Mit einer serververwalteten Bereitstellung können Sie die Datei Ihres Unternehmens managed-settings.json so konfigurieren, dass verschiedene Governanceeinstellungen auf Gruppen von Benutzern basierend auf ihrer Unternehmensteammitgliedschaft angewendet werden. Das Unternehmen definiert alle Einstellungen an einem zentralen Ort, und die Mitgliedschaft im Unternehmensteam bestimmt, welche Benutzer einen bestimmten Wertesatz erhalten. Wenn Sie die managed-settings.json Datei noch nicht erstellt haben, lesen Sie Erste Schritte mit unternehmensverwalteten Einstellungen.

Damit Enterprise-Teams einen Unternehmensstandard ersetzen können, markieren Sie den Schlüssel als overridable in managed-settings.json. Ein überschreibbarer Schlüssel verwendet den Wert des Unternehmensteams, wenn er festgelegt ist, oder greift auf die Standardeinstellung Ihres Unternehmens zurück, wenn das Unternehmensteam ihn nicht festlegt.

Unterstützte Schlüssel

Die { "overridable": <VALUE> } Syntax gilt für die Schlüssel model, autoTier, fusionTier, permissions.deny, permissions.allow, permissions.disableBypassPermissionsMode, permissions.ask, allowedMcpServers, deniedMcpServers, extraKnownMarketplaces, strictKnownMarketplaces und sandbox.

enabledPlugins wirkt additiv. Das Unternehmen managed-settings.json legt einen Basisplan fest, und eine Unternehmensteamdatei kann darüber hinaus weitere Plug-Ins hinzufügen.

Eine vollständige Beschreibung dieser Schlüssel und deren Syntax finden Sie unter Unternehmensverwaltete Einstellungen.

Überschreiben von Einstellungen für bestimmte Enterprise-Teams

Diese Anweisungen gelten für serverseitig verwaltete Bereitstellungen (ein managed-settings.json, das auf GitHub gehostet wird). Andere Bereitstellungsmethoden unterstützen keine Überschreibungen durch das Unternehmensteam und würden erfordern, dass Sie über Ihre MDM-Plattform unterschiedliche Einstellungen an verschiedene Benutzergruppen bereitstellen.

Sie verwenden copilot/team-mappings.json und das copilot/teams/ Verzeichnis, um zu konfigurieren, welche Unternehmensteams Einstellungen verwenden sollten, die sich von Ihren Standardwerten copilot/managed-settings.json unterscheiden.

Nachdem Sie diesen Abschnitt abgeschlossen haben, hat Ihr .github-private Repository die folgende Struktur:

• .github-private/
  • copilot/

    ---

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

Schritte

1. Markieren Sie in der Datei Ihres Unternehmens copilot/managed-settings.json jeden Schlüssel, den Sie mit der { "overridable": <VALUE> } Syntax außer Kraft setzen möchten. Die json Dateien, die Sie Enterprise-Teams zuordnen, können nur unterschiedliche Werte für Schlüssel senden, die Sie als überschreibbar markieren.

   Ein von Ihnen in managed-settings.json bereitgestellter overridable Wert ist der Standardwert, wenn Dateien von Enterprise-Teams keinen anderen Wert für einen bestimmten Schlüssel deklarieren.

   Um beispielsweise model, disableBypassPermissionsMode und allowedMcpServers an Unternehmensteams zurückzustellen:

   {
     "model": { "overridable": "auto" },
     "permissions": {
       "disableBypassPermissionsMode": { "overridable": "disable" }
     },
     "allowedMcpServers": {
       "overridable": [
         { "serverUrl": "https://mcp.company.com/*" }
       ]
     }
   }
   

2. Erstellen Sie im .github-private Repository Ihres Unternehmens copilot/team-mappings.json. Ordnen Sie jede Enterprise-Teameinstellungsdatei einem oder mehreren Enterprise-Team-Slugs zu. Der Schlüssel ist der Dateiname der Einstellungen, und der Wert ist ein Array von Enterprise-Team-Slugs, sodass Sie eine Datei auf mehrere Enterprise-Teams anwenden können.

   {
     "devs.json": ["developers-all", "finops-dev"],
     "ai-users.json": ["ai-baseline-trained"],
     "frontier.json": ["ai-pioneers"]
   }
   

3. Erstellen Sie die Einstellungsdatei des Enterprise-Teams unter copilot/teams/. Sie können alle Schlüssel, die Sie als überschreibbar gekennzeichnet haben, restriktivere Werte für autoTier sowie den additiven Schlüssel enabledPlugins einbeziehen. Alle anderen Schlüssel werden weiterhin durch die Standardvorgabe Ihres Unternehmens gesteuert.

   {
     "model": "unmanaged",
     "permissions": {
       "disableBypassPermissionsMode": "unmanaged"
     },
     "allowedMcpServers": [
       { "serverUrl": "https://team-specific-mcp.company.com/*" }
     ]
   }
   

4. Übertragen und pushen Sie Ihre Änderungen in den Standardzweig.

GitHub wertet die Enterprise-Teammitgliedschaft aus und wendet übereinstimmende Einstellungen für jede Person an. Wenn ein Benutzer zu mehreren Unternehmensteams gehört, werden seine Unternehmensteamdateien mit dem am wenigsten restriktiven Wert für jeden Schlüssel kombiniert und dann unter den Unternehmenseinstellungen angewendet, bei denen Plattformentscheidungen immer gewinnen.