Referenz für unternehmensverwaltete Einstellungen

Verwenden Sie diesen Verweis, um die derzeit unterstützten Schlüssel zu verstehen in managed-settings.json.

Informationen zu Bereitstellungsmethoden finden Sie unter Konfigurieren von unternehmensverwalteten Einstellungen.

Rangfolgeregeln

Wenn mehrere Einstellungsquellen vorhanden sind, haben einstellungen weiter oben in dieser Liste Vorrang vor den Einstellungen weiter unten in der Liste:

1. MDM-verwaltete Einstellungen
2. Serververwaltete Einstellungen
3. Dateibasierte Einstellungen
4. Einstellungen auf Benutzerebene

Unterstützte Schlüssel

Beispielkonfiguration

Das folgende Beispiel zeigt diese Schlüssel in einer verwalteten Einstellungsdatei.

{
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "model": "auto"
  },
  "enabledPlugins": {
    "my-plugin@agent-skills": true
  },
  "extraKnownMarketplaces": {
    "agent-skills": {
      "source": {
        "source": "github",
        "repo": "OWNER/REPO"
      }
    }
  },
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "OWNER/REPO"
    }
  ],
  "telemetry": {
    "enabled": true,
    "endpoint": "https://otel-collector.example.com",
    "protocol": "http/protobuf",
    "captureContent": false,
    "lockCaptureContent": true,
    "serviceName": "copilot",
    "resourceAttributes": {
      "deployment.environment": "production"
    },
    "headers": {
      "Authorization": "Bearer TOKEN"
    }
  }
}

enabledPlugins

Definiert Plug-Ins, die für alle Unternehmensbenutzer automatisch installiert oder blockiert werden. Jeder Eintrag verwendet das Format PLUGIN-NAME@MARKETPLACE-NAME als Schlüssel mit einem booleschen Wert: true um das Plug-In zu aktivieren oder false zu deaktivieren. Siehe Informationen zu unternehmensverwalteten Plug-In-Standards.

extraKnownMarketplaces

Definiert zusätzliche Plug-In-Marketplaces, die benutzern zur Verfügung stehen. Jeder Eintrag ist ein benanntes Marketplace-Objekt, das eine source Eigenschaft enthält. Die folgenden Quelltypen werden unterstützt:

• "github" — erfordert repo format OWNER/REPO ; optional ref (Verzweigung, Tag oder SHA) und path (Unterverzeichnis)
• "git" — erfordert url; optional ref und path
• "directory" — erfordert path

Siehe Informationen zu unternehmensverwalteten Plug-In-Standards.

strictKnownMarketplaces

Beschränkt die Plug-In-Installation auf nur die vom Unternehmen explizit definierten Marketplaces. Ein leeres Array bedeutet einen vollständigen Sperrmodus. Jeder Eintrag ist ein Marketplace-Objekt mit einer source Eigenschaft, die den Quelltyp angibt. Die folgenden Quelltypen werden unterstützt:

• "github" — im Format erforderlich repo``OWNER/REPO ; optional ref und path
• "git" — erfordert url; optional ref und path
• "url" — erfordert url; optionales headers Objekt
• "npm" — erfordert package
• "file" — erfordert path
• "directory" — erfordert path
• "hostPattern" — erfordert hostPattern (regex matching marketplace hosts)
• "pathPattern" — erfordert pathPattern (regex-übereinstimmende Marketplace-Pfade)

permissions

disableBypassPermissionsMode

Verhindert, dass Benutzer den Umgehungsmodus (auch als "YOLO-Modus" bezeichnet) in Copilot CLI und VS Codeaktivieren. Mit dem Umgehungsmodus kann ein Agent Befehle ausführen, auf Dateien zugreifen und URLs abrufen, ohne um Genehmigung zu bitten.

Wenn Sie disableBypassPermissionsMode auf "disable" festlegen, können Benutzer den Bypassmodus in beiden Clients nicht aktivieren:

• In Copilot CLI, die --yolo Optionen und --allow-all Befehlszeilenoptionen und die /yolo Befehle und /allow-all Schrägstriche werden blockiert. Einzelne Flags wie --allow-all-tools und --allow-all-paths werden nicht blockiert.
• In VS Code, die globale Einstellung für die automatische Genehmigung (chat.tools.global.autoApprove), die auch als "YOLO-Modus" bezeichnet wird, ist deaktiviert und kann nicht erneut aktiviert werden.

model

Legt die Automatische Modellauswahl als Standard für neue Unterhaltungen in Copilot CLI. Siehe Über CopilotAutomatische Modellauswahl.

Wenn Sie diese Einstellung festlegen permissions.model``"auto", verwenden neue Sitzungen das Automatische Modell, es sei denn, der Benutzer gibt ein anderes Modell pro Unterhaltung an.

telemetry

Konfiguriert den OpenTelemetry-Export, das Routing Copilot von Nutzungsdaten an einen Sammler Ihrer Wahl.

Wenn Sie die telemetry Eigenschaft festlegen, Copilot wird telemetrie an den angegebenen Endpunkt gesendet. Die folgenden Untereigenschaften werden unterstützt:

• enabled: Legen Sie fest, dass true der Telemetrieexport aktiviert oder false deaktiviert werden soll.
• endpoint: Die URL Ihres OTLP-Sammlers (z. B https://otel-collector.example.com. ).
• protocol: Das Transportprotokoll für den Telemetrieexport. Akzeptierte Werte sind "http/json" und "http/protobuf".
• captureContent: Legen Sie diese Einstellung fest, true um Eingabeaufforderungs- und Antwortinhalte in die Telemetrienutzlast einzuschließen oder false auszuschließen.
• lockCaptureContent: Legen Sie fest, um zu true verhindern, dass Benutzer die captureContent Einstellung ändern.
• serviceName: Eine Bezeichnung für den Telemetriedienstnamen (z. B "copilot". ).
• resourceAttributes: Ein Objekt von OpenTelemetry-Ressourcenattributen, die an alle exportierten Telemetrie angefügt werden sollen (z. B {"deployment.environment": "production"}. ).
• headers: Ein Objekt von HTTP-Headern, das in jede Telemetrieanforderung eingeschlossen werden soll (z. B. eine Authorization Kopfzeile für den Sammler).