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

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

우선 순위 규칙

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

MDM 관리 설정
서버 관리 설정
파일 기반 설정
사용자 수준 설정

지원되는 키

Key	Type	허용되는 값	Purpose
`permissions.disableBypassPermissionsMode`	`string`	`"disable"`	바이패스 또는 YOLO 스타일의 모두 허용 동작을 비활성화합니다
`permissions.model`	`string`	`"auto"`	자동 모델 선택을 새 대화의 기본값으로 설정
`enabledPlugins`	`object`	키 형식: `PLUGIN-NAME@MARKETPLACE-NAME`; 값: `true` (사용) 또는 `false` (사용 안 함)	키별 특정 플러그 인 사용 또는 사용 안 함
`extraKnownMarketplaces`	`object`	명명된 마켓플레이스 개체 지원되는 원본 유형: `"github"`, "git"``"directory"	사용자가 액세스할 수 있는 플러그 인 마켓플레이스 추가
`strictKnownMarketplaces`	`array`	마켓플레이스 개체의 배열; 지원되는 원본 유형: `"github"`,`"git"`, `"url"`, "npm"``"file", `"directory"`, "hostPattern"``"pathPattern"	플러그 인 설치를 명시적으로 나열된 마켓플레이스로 제한
`telemetry`	`object`
`enabled` (`boolean`), `endpoint` (`string`), `protocol` (`"http/json"` 또는 `"http/protobuf"`), `captureContent` (`boolean`), `lockCaptureContent` (`boolean`), `serviceName` (`string`), `resourceAttributes` (`object`) `headers` (`object`)
VS Code에 대한 OpenTelemetry 내보내기를 구성합니다.

구성 예

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

{
  "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`

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

`extraKnownMarketplaces`

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

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

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

`strictKnownMarketplaces`

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

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

`permissions`

`disableBypassPermissionsMode`

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

disableBypassPermissionsMode을(를) "disable"(으)로 설정하면 사용자는 두 클라이언트 모두에서 바이패스 모드를 켤 수 없습니다.

코파일럿 CLI에서는 --yolo 및 --allow-all 명령줄 옵션과 /yolo 및 /allow-all 슬래시 명령은 차단됩니다. --allow-all-tools 및 --allow-all-paths와 같은 개별 플래그는 차단되지 않습니다.
VS Code에서는 "YOLO 모드"라고도 하는 전역 자동 승인 설정(chat.tools.global.autoApprove)이 꺼져 있으며 다시 활성화할 수 없습니다.

`model`

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

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

`telemetry`

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

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

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

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

이 기사에서