엔터프라이즈 관리 설정 참조

이 참조를 통해 managed-settings.json에서 현재 지원되는 키를 이해하세요.

배포 방법 및 지원되는 클라이언트는 엔터프라이즈 관리 설정 구성을 참조하세요.

우선 순위 규칙

여러 설정 원본이 있는 경우 이 목록의 앞부분에 있는 설정이 목록의 뒷부분에 있는 설정보다 우선합니다.

1. MDM 관리 설정
2. 서버 관리 설정
3. 파일 기반 설정
4. 사용자 수준 설정

지원되는 키

구성 예

다음 예제에서는 관리되는 하나의 설정 파일에서 이러한 키를 보여 냅니다.

{
  "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"
    }
  },
  "remoteControl": {
    "mode": "requireSSO",
    "githubDotComOrganizations": ["ORG-NAME"]
  }
}

enabledPlugins

모든 엔터프라이즈 사용자에 대해 자동으로 설치되거나 차단되는 플러그 인을 정의합니다. 각 항목은 PLUGIN-NAME@MARKETPLACE-NAME를 키로 사용하는 형식이며, 불리언 값으로 true는 플러그인이 활성화되어 있어야 함을, false는 비활성화되어 있어야 함을 나타냅니다. 엔터프라이즈 관리 플러그 인 표준 정보을(를) 참조하세요.

extraKnownMarketplaces

사용자가 사용할 수 있는 추가 플러그 인 마켓플레이스를 정의합니다. 각 항목은 source 속성을 포함하는 이름이 지정된 마켓플레이스 개체입니다. 지원되는 원본 유형은 다음과 같습니다.

• "github" — repo 형식의 OWNER/REPO이 필요합니다. 선택 사항: ref(브랜치, 태그 또는 SHA) 및 path(하위 디렉터리)
• "git" — url 필요; ref 및 path 선택 사항
• "directory" — path 필요

엔터프라이즈 관리 플러그 인 표준 정보을(를) 참조하세요.

strictKnownMarketplaces

플러그 인 설치를 엔터프라이즈에서 명시적으로 정의한 마켓플레이스로만 제한합니다. 빈 배열은 전체 잠금을 의미합니다. 각 항목은 원본 형식을 나타내는 속성이 있는 source Marketplace 개체입니다. 지원되는 원본 유형은 다음과 같습니다.

• "github" — repo 형식의 OWNER/REPO이(가) 필요합니다. ref 및 path는 선택 사항입니다.
• "git" — url 필요; ref 및 path 선택 사항
• "url" — url 필요; 선택 사항 headers 개체
• "npm" — package 필요
• "file" — path 필요
• "directory" — path 필요
• "hostPattern" — 필요함 hostPattern (정규식과 일치하는 마켓플레이스 호스트)
• "pathPattern" — 필요함 pathPattern (마켓플레이스 경로와 일치하는 정규식)

permissions

disableBypassPermissionsMode

사용자가 바이패스 모드("YOLO 모드"라고도 함)를 사용하도록 설정하지 못하도록 합니다. 바이패스 모드를 사용하면 에이전트가 승인을 요청하지 않고 명령을 실행하고, 파일에 액세스하고, URL을 가져올 수 있습니다.

disableBypassPermissionsMode을(를) "disable"(으)로 설정하면 사용자는 바이패스 모드를 켤 수 없습니다:

• 에서 코파일럿 CLI모든 권한(--yolo및 --allow-all개별 --allow-all-tools``--allow-all-paths``--allow-all-urls 및 옵션)을 허용하기 위한 모든 명령줄 옵션은 시작 시 표시되지 않으며 상승된 권한을 부여할 수 없습니다. /yolo 및 /allow-all 슬래시 명령도 차단됩니다.
• 에서 VS Code전역 자동 승인 설정(chat.tools.global.autoApprove)이 해제되어 다시 사용하도록 설정할 수 없습니다.
• 에서 GitHub Copilot 앱"도구 사용 권한"에 대한 "모두 허용" 설정이 세션 설정에서 차단됩니다.

model

자동 모델 선택을 새 대화의 기본값으로 설정합니다. 정보 Copilot자동 모델 선택을(를) 참조하세요.

설정 permissions.model``"auto"하면 사용자가 대화별로 다른 모델을 지정하지 않는 한 새 세션에서 자동 모델을 사용합니다.

telemetry

선택한 수집기로 사용량 현황 데이터를 라우팅하여 Copilot OpenTelemetry 내보내기를 구성합니다.

이 속성은 코파일럿 CLI 및 VS Code에서 지원됩니다.

telemetry 속성을 설정하면 Copilot 원격 분석 데이터가 사용자가 지정한 엔드포인트로 전송됩니다. 지원되는 하위 속성은 다음과 같습니다.

• enabled: 원격 분석 내보내기를 true 켜거나 false 해제하도록 설정합니다.
• endpoint: OTLP 수집기의 URL(예: https://otel-collector.example.com)입니다.
• protocol: 원격 분석 내보내기를 위한 전송 프로토콜입니다. 허용되는 값은 "http/json" 및 "http/protobuf"입니다.
• captureContent: 원격 분석 페이로드에 프롬프트 및 응답 콘텐츠를 포함하거나 true 제외하도록 설정합니다false.
• lockCaptureContent: 사용자가 true 설정을 변경하지 못하도록 하려면 captureContent로 설정합니다.
• serviceName: 원격 분석 서비스 이름(예: "copilot")에 대한 레이블입니다.
• resourceAttributes: 내보낸 모든 텔레메트리에 추가할 OpenTelemetry 리소스 특성 객체입니다(예: {"deployment.environment": "production"}).
• headers: 각 텔레메트리 요청에 포함할 HTTP 헤더 객체입니다(예: 수집기용 Authorization 헤더).

remoteControl

디바이스에서 호스트되는 세션을 원격으로 제어할 수 있는지 여부를 Copilot 제한합니다. 이는 다른 디바이스에서 호스트되는 세션을 원격으로 제어하는 사용자의 기능에 영향을 주지 않습니다.

• mode: 디바이스에서 세션의 원격 제어를 방지하거나"disabled", 나열된 "requireSSO"조직에 대해 SSO 권한이 부여된 클라이언트의 원격 제어만 허용하거나githubDotComOrganizations, 제한 없이 허용 "enabled" 하도록 설정됩니다.
• githubDotComOrganizations: 조직 로그인의 배열입니다. mode이 "requireSSO"인 경우 필요합니다.