비즈니스용 Windows 업데이트를 통해 디바이스 구성 보고서 구성 스크립트
비즈니스용 Windows 업데이트 보고서 구성 스크립트는 비즈니스용 Windows 업데이트 보고서에 사용하기 위해 Microsoft에 데이터를 보내도록 디바이스를 구성하는 권장 방법입니다. 스크립트는 레지스트리 키 지원 정책을 구성하고 필요한 서비스가 실행 중인지 확인하는 등의 작업을 수행합니다. 이 스크립트는 구성 중인 정책 외부의 구성 문제가 있는지 여부에 대한 피드백을 제공할 수 있으므로 비즈니스용 Windows 업데이트 보고서에 대한 디바이스 수동 구성에 설명된 필수 정책을 구성하는 데 권장되는 보완 사항입니다.
스크립트 정보
구성 스크립트는 레지스트리 키를 직접 구성합니다. 레지스트리 키는 그룹 정책 또는 MDM과 같은 정책 설정에서 덮어쓸 수 있습니다. 스크립트를 사용하여 디바이스를 다시 구성해도 그룹 정책 및 MDM의 경우 이전에 설정된 정책이 다시 구성되지 않습니다. 그룹 정책 또는 MDM 구성과 비즈니스용 Windows 업데이트용 디바이스 수동 구성 보고서에 나열된 필수 구성 간에 충돌이 있는 경우 비즈니스용 Windows 업데이트 보고서에 디바이스 데이터가 올바르게 표시되지 않을 수 있습니다.
Microsoft 다운로드 센터에서 스크립트를 다운로드할 수 있습니다.
이 스크립트를 구성하는 방법
이 스크립트의 두 기본 파일은 및 RunConfig.bat입니다ConfigScript.ps1. 자체의 지침에 따라 구성 RunConfig.bat 한 다음 에 입력된 RunConfig.bat매개 변수를 사용하여 실행됩니다ConfigScript.ps1..bat 스크립트를 사용하는 방법에는 파일럿 모드 또는 배포 모드의 두 가지가 있습니다.
중요
PsExec 는 시스템 컨텍스트에서 스크립트를 실행하는 데 사용됩니다. 디바이스가 구성되면 디바이스에서 PsExec.exe 제거합니다.
이 스크립트를 사용하는 방법
RunConfig.bat 파일을 편집하여 다음 변수를 구성한 다음 편집된 .bat 파일을 실행합니다.
| 변수 | 허용되는 값 및 설명 | 예제 |
|---|---|---|
| runMode |
파일럿 (기본값): 추가 진단 및 로깅이 있는 자세한 정보 표시 모드입니다. 파일럿 모드는 스크립트의 테스트 실행 또는 문제 해결에 가장 적합합니다. 배포: 추가 진단을 실행하거나 추가 로깅을 추가하지 않습니다. |
runMode=Pilot |
| logPath | 로그가 저장되는 경로입니다. 로그의 기본 위치는 입니다 .\UCLogs. |
logPath=C:\temp\logs |
| logMode |
0: 콘솔에만 로그 1 (기본값): 파일 및 콘솔에 로그합니다. 2: 파일에만 로그합니다. |
logMode=2 |
| DeviceNameOptIn |
true (기본값): 디바이스 이름이 Microsoft로 전송됩니다. false: 디바이스 이름이 Microsoft로 전송되지 않습니다. |
DeviceNameOptIn=true |
| ClientProxy |
직접 (기본값): 프록시가 사용되지 않습니다. 엔드포인트에 대한 연결은 직접입니다. 시스템: 인증 없이 시스템 프록시가 사용됩니다. 이 유형의 프록시는 일반적으로 netsh 로 구성되며 를 사용하여 netsh winhttp show proxy확인할 수 있습니다.
사용자: 프록시는 IE를 통해 구성되며 사용자 인증이 필요하거나 필요하지 않을 수 있습니다. 자세한 내용은 Windows 업데이트 클라이언트에서 Windows 업데이트 웹 사이트에 연결하는 데 사용할 프록시 서버를 결정하는 방법을 참조하세요. |
ClientProxy=Direct |
| 근원 | .bat 파일 및 PowerShell 스크립트에서 종속성을 찾는 데 사용됩니다. 이 값은 변경하지 않는 것이 좋습니다. | source=%~dp0 |
스크립트 오류
| 오류 | 설명 |
|---|---|
| 1 | 예기치 않은 오류 |
| 12 | CheckVortexConnectivity가 실패했습니다. 자세한 내용은 로그 출력을 확인합니다. |
| 12 | CheckVortexConnectivity를 실행할 때 예기치 않은 오류가 발생했습니다. |
| 16 | 디바이스에서 다시 부팅이 보류 중입니다. 디바이스를 다시 시작한 다음 스크립트를 다시 실행합니다. |
| 17 | CheckRebootRequired에서 예기치 않은 예외가 발생했습니다. |
| 27 | 시스템 계정이 아닙니다. |
| 30 | 엔터프라이즈 인증 프록시를 사용하지 않도록 설정할 수 없습니다. UTC가 인증된 프록시 환경에서 작동하려면 이 레지스트리 값이 0이어야 합니다. |
| 34 | 프록시 설정을 확인하려고 할 때 예기치 않은 예외가 발생했습니다. |
| 35 | 사용자 프록시를 확인할 때 예기치 않은 예외입니다. |
| 37 | 로그를 수집할 때 예기치 않은 예외입니다. |
| 40 | 원격 분석을 확인하고 설정할 때 예기치 않은 예외입니다. |
| 41 | 로그온한 사용자를 가장할 수 없습니다. |
| 42 | 로그온한 사용자를 가장하려고 할 때 예기치 않은 예외입니다. |
| 43 | 로그온한 사용자를 가장하려고 할 때 예기치 않은 예외입니다. |
| 44 | CheckDiagTrack 서비스를 실행할 때 오류가 발생했습니다. |
| 45 | DiagTrack.dll 찾을 수 없습니다. |
| 50 | DiagTrack 서비스가 실행되고 있지 않습니다. |
| 51 | Census.exe 실행하려고 할 때 예기치 않은 예외가 발생했습니다. |
| 52 | Census.exe 찾을 수 없습니다. |
| 54 | MSA(Microsoft 계정 로그인 도우미) 서비스를 사용할 수 없습니다. |
| 55 | SetDeviceNameOptIn에 대한 새 레지스트리 경로를 만들지 못했습니다. |
| 56 | 레지스트리 경로에서 SetDeviceNameOptIn에 대한 속성을 만들지 못했습니다. |
| 57 | SetDeviceNameOptIn에 대한 값을 업데이트하지 못했습니다. |
| 58 | SetDeviceNameOptIn에서 예기치 않은 예외가 발생했습니다. |
| 59 | OneSettings를 정리하려고 할 때 레지스트리 경로에서 LastPersistedEventTimeOrFirstBoot 속성을 삭제하지 못했습니다. |
| 60 | OneSettings를 정리하려고 할 때 레지스트리 키를 삭제하지 못했습니다. |
| 61 | OneSettings를 정리하려고 할 때 예기치 않은 예외가 발생했습니다. |
| 62 | AllowTelemetry 레지스트리 키는 올바른 유형의 REG_DWORD 아닙니다. |
| 63 | AllowTelemetry는 적절한 값으로 설정되지 않았으며 스크립트에서 설정할 수 없습니다. |
| 64 | AllowTelemetry는 올바른 유형의 REG_DWORD 아닙니다. |
| 66 | UTC 연결 및 최근 업로드를 확인하지 못했습니다. |
| 67 | UTC CSP를 확인할 때 예기치 않은 오류가 발생했습니다. |
| 99 | 디바이스는 Windows 10 또는 Windows 11이 아닙니다. |
| 100 | 비즈니스용 Windows 업데이트 보고서를 사용하려면 디바이스가 Microsoft Entra 조인 또는 Microsoft Entra 하이브리드 조인이어야 합니다. |
| 101 | 예기치 않은 예외로 Microsoft Entra 조인이 실패했는지 확인합니다. |
| 102 | DisableOneSettingsDownloads 정책을 사용하도록 설정하면 안 됩니다. 이 정책을 사용하지 않도록 설정하세요. |