--- title: "Windows용 명령줄 인터페이스" slug: "command-line-interface-for-windows" updated: 2025-08-04T16:35:55Z published: 2025-08-04T16:38:25Z canonical: "support.anydesk.com/command-line-interface-for-windows" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.anydesk.com/llms.txt > Use this file to discover all available pages before exploring further. # Windows용 명령줄 인터페이스 AnyDesk 명령줄 인터페이스 (CLI)를 사용하면 관리자와 고급 사용자가 설치, 구성, 클라이언트 및 세션 관리, 네트워크 설정을 자동화할 수 있습니다. 이 문서에서는 Windows 명령 프롬프트 또는 배치 파일과 같은 스크립트 내에서 AnyDesk 명령을 사용하여 배포 및 관리를 간소화하는 방법을 설명합니다. > [!CAUTION] > 🚨 **중요하다** > > 모든 명령은 있는 디렉토리 `AnyDesk.exe` 에서 실행하거나 전체 실행 가능 경로를 지정해야 합니다. AnyDesk 실행 파일의 위치는 클라이언트 유형에 따라 다릅니다. - [**anydesk.com**](https://anydesk.com/en/downloads/windows)**에서 다운로드한 표준 클라이언트** 는 일반적으로 다음에 설치됩니다. `C:\Program Files (x86)\AnyDesk\AnyDesk.exe` - [**my.anydesk.com**](http://my.anydesk.com/v2)**를 통해 생성된 사용자 지정 클라이언트는** 일반적으로 다음과 같이 설치됩니다. `C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe` 는 `<prefix>` 계정의 고유 식별자입니다. 빌드 **탭[my.anydesk](http://my.anydesk.com/v2) >** 찾을 수 > **일반** 섹션에서 원하는 빌드 >를 선택하고 **접두사** 필드를 선택합니다. --- ## 설치 이 섹션에서는 명령줄을 사용하여 AnyDesk Windows 클라이언트를 설치하거나 업데이트하는 방법에 대한 지침을 제공합니다. 스크립트, 시스템 배포 프로세스 또는 수동 설정 중에 이러한 명령을 사용할 수 있습니다. 설치 매개변수를 사용하면 바로가기 생성, 자동 모드 및 업데이트 기본 설정과 같은 특정 설치 동작을 정의할 수 있습니다. ### 설치 명령 CLI를 사용하여 AnyDesk를 설치하거나 업데이트하려면 다음 명령 형식을 사용하십시오. ```plaintext anydesk.exe --install ``` 예를 들어: ```plaintext anydesk.exe --install  “C:\Program Files (x86)\AnyDesk” --start-with-win --create-desktop-icon ``` MSI 기반 배포의 경우: ```plaintext anydesk.msi (optional: INSTALL="") ``` ### **설치 매개변수** | **매개 변수** | **묘사** | | --- | --- | | **--install <위치>** | 지정된 위치(예: `C:\Program Files (x86)\AnyDesk`)에 AnyDesk를 설치합니다. | | **--승리로 시작** | Windows에서 자동으로 실행되도록 AnyDesk를 구성합니다. | | **--만들기 단축키** | 시작 메뉴 바로 가기를 추가합니다. | | **--데스크탑 만들기 아이콘** | 바탕 화면 단축키를 추가합니다. | | **--제거 우선** | 새 버전을 설치하기 전에 현재 버전을 제거합니다. 수동 업데이트에 유용합니다. | | **--조용하다** | 사용자 인터페이스 및 오류 프롬프트 없이 설치를 실행합니다. | | **--수동으로 업데이트** | 수동 업데이트를 사용하도록 설정합니다(사용자 지정 클라이언트의 기본값). | | **--업데이트 비활성화** | AnyDesk 업데이트를 비활성화합니다. | | **--업데이트 자동** | 자동 업데이트를 사용하도록 설정합니다(표준 클라이언트의 경우 기본값, 사용자 지정 클라이언트의 경우 사용할 수 없음) | --- ## AnyDesk 클라이언트 AnyDesk 실행 파일(`anydesk.exe`)은 관리자가 클라이언트를 제어하고 구성할 수 있는 광범위한 명령을 제공합니다. 이러한 명령은 개별적으로 또는 자동화 스크립트 내에서 사용하여 여러 시스템에서 관리 작업을 간소화할 수 있습니다. ### 클라이언트 명령 아래 예제에서는 라이센스 키 등록 또는 무인 액세스 암호 설정과 같은 키 클라이언트 명령을 사용하는 방법을 보여줍니다. 이러한 명령은 초기 설정 중 또는 클라이언트 구성을 자동화할 때 자주 사용됩니다. | **명령** | **묘사** | | --- | --- | | **anydesk.exe <매개 변수>** | 사용 가능한 옵션의 전체 목록은 [Client command parameters](/v1/docs/command-line-interface-for-windows#client-command-parameters)를 참조하십시오. | | **'에코 "\| anydesk.exe --등록 라이센스** | 지정된 라이센스 키를 등록합니다. 관리자 권한이 필요합니다. | | **'에코 "\| anydesk.exe --비밀번호 설정** | 무인 액세스에 대해 지정된 암호를 설정합니다. | ### **클라이언트 명령 매개변수** 이 표에는 AnyDesk 클라이언트에 사용할 수 있는 개별 명령줄 매개변수가 나열되어 있습니다. 이러한 매개 변수는 클라이언트를 직접 구성하거나 제어하는 데 사용할 `anydesk.exe` 수 있으며 일반적으로 스크립트 또는 관리 설정에서 사용됩니다. | **매개 변수** | **묘사** | | --- | --- | | **--제거** | 그래픽 프롬프트로 AnyDesk를 제거합니다. | | **--제거하다** | 프롬프트나 UI 없이 AnyDesk를 자동으로 제거합니다. | | **--시작하다** | AnyDesk 백그라운드 서비스를 시작합니다. | | **--서비스 중지** | AnyDesk 백그라운드 서비스를 중지합니다. | | **--다시 시작 서비스** | AnyDesk 백그라운드 서비스를 다시 시작합니다. | | **--비밀번호 제거** | 무인 액세스 암호를 삭제합니다(관리자 권한 필요). **메모:** 이렇게 하면 사용자 지정 클라이언트에서 사전 설정된 암호를 제거할 수 없습니다. | | **--라이센스 제거** | 클라이언트에서 라이센스 키를 제거합니다. **메모:** 계정을 통해 로그인한 사용자는 로그아웃되지 않습니다. | | **--별칭 가져오기** | AnyDesk 별칭을 표시합니다. 일반적으로 스크립트에서 사용됩니다. | | **--아이디 얻기** | AnyDesk ID를 표시합니다. 일반적으로 스크립트에서 사용됩니다. | | **--상태 가져오기** | 클라이언트의 온라인 상태를 표시합니다. | | **--버전** | 설치된 AnyDesk 버전을 표시합니다. | | **--설정** | 기본(로컬) 설정 페이지를 엽니다. | | **--관리자 설정** | 전역(관리자 수준) 설정 페이지를 엽니다. | | **--설정:** | 지정된 설정 섹션을 엽니다. 지원되는 매개변수: `ui`, , `privacy``recording``printer``wol``alias``capture``license``video``audio``connection``file_transfer``security``about` | | **--관리자 설정:** | 전역 설정의 지정된 섹션을 엽니다. 지원되는 매개변수: `capture`, `security`, `connection`, `recording` | | **--면책 조항** | 사용자 지정 고지 사항 메시지를 표시합니다. 이 옵션을 사용하도록 설정된 사용자 지정 클라이언트에서만 작동합니다. | **AnyDesk ID를 얻는 배치 스크립트의 예:** ```plaintext @echo off for /f "delims=" %%i in ('"C:\Program Files (x86)\AnyDesk\AnyDesk.exe" --get-id') do set ID=%%i echo AnyDesk ID is: %ID% pause ``` --- ## 권한 프로필 명령(AnyDesk 7+) 권한 프로필을 통해 관리자는 원격 세션에 대한 사용자 지정 액세스 제어 설정을 정의할 수 있습니다. 이러한 프로필은 명령줄을 통해 생성, 구성 및 관리할 수 있습니다. 이는 AnyDesk 버전 7 이상에서 지원됩니다. ### 권한 프로필 만들기 ```plaintext anydesk.exe --add-profile + + ... ``` 라는 새 `<name>`권한 프로필을 만듭니다. 기본적으로 모든 권한이 비활성화되어 있습니다. 공백으로 구분된 특정 권한을 활성화하는 데 사용합니다 `+<permission>` . 지원되는 권한: - `audio` - `input` - `clipboard` - `clipboard_files` - `block_input` - `sas (CTRL+ALT+DEL action)` - `restart` - `file_manager` - `lock_desk` - `sysinfo` - `whiteboard` - `tcp_tunnel` - `VPN` - `user_pointer` - `privacy_feature` - `record_session` ### 무인 액세스 암호로 프로필 만들기 ```plaintext echo | anydesk.exe --add-profile + + ... ``` 지정된 무인 액세스 암호로 명명된 `<name>` 권한 프로필을 만듭니다. 권한은 위와 동일한 방식으로 정의해야 합니다. ### 기존 프로필에 대한 암호 설정 ```plaintext echo | anydesk.exe --set-password ``` 지정된 프로필에 대한 무인 액세스 암호를 할당하거나 업데이트합니다. - 사용자 지정 프로필의 경우: 권한 프로필 이름을 사용합니다. - 기본 프로필의 경우 다음을 사용합니다. - `_default` –기본값 - `_full_access` – 전체 액세스 - `_screen_sharing` – 화면 공유 - `_unattended_access` – [Unattended Access](/v1/docs/permission-profiles) ### 프로필에서 비밀번호 제거 ```plaintext anydesk.exe --remove-password ``` 지정된 프로필에서 무인 액세스 암호를 제거합니다. > [!TIP] > 💡 **메모** > > 이 명령은 사용자 지정 클라이언트 구성에서 사전 설정된 암호를 제거할 수 없습니다. --- ## 명령줄을 통해 세션 시작 실행 파일을 사용하여 명령줄에서 직접 원격 세션을 시작할 수 있습니다 `anydesk.exe` . ### 연결 명령 이는 AnyDesk를 스크립트, 관리 도구 또는 자동화 프로세스와 통합하는 데 유용할 수 있습니다. **클라이언트에 연결** ```plaintext anydesk.exe ``` 지정된 AnyDesk ID 또는 별칭에 대한 원격 세션을 시작합니다. - `<ID_or_Alias>` - 원격 클라이언트의 AnyDesk 주소입니다. - `<additional_parameters>` - 세션을 사용자 정의하는 선택적 매개변수입니다. 추가 매개 변수는 [Optional session parameters](/v1/docs/command-line-interface-for-windows#optional-session-parameters)를 참조하십시오. **암호를 사용하여 연결** ```plaintext echo | anydesk.exe --with-password ``` 지정된 클라이언트에 대한 세션을 시작하고 무인 액세스에 대해 지정된 암호를 제출합니다. ### 선택적 세션 매개 변수 세션 명령에 다음 매개 변수를 추가하여 세션 시작 방법을 수정할 수 있습니다. | **명령** | **묘사** | | --- | --- | | **--파일 전송** | 파일 전송 세션을 시작합니다. | | **--전체 화면** | 전체 화면 모드에서 세션을 시작합니다. | | **--평야** | 테두리와 메뉴 옵션이 없는 창에서 세션을 시작합니다. | --- ## 프록시 명령 명령줄 매개변수를 사용하여 AnyDesk의 HTTP 프록시 설정을 구성할 수 있습니다. 이는 엄격한 네트워크 정책이 있거나 프록시 인증이 필요한 환경에 특히 유용합니다. > [!NOTE] > 🦉 프록시 설정에 대한 자세한 내용은[**this article**](/v1/docs/settings-1)를 참조하십시오 . ### 프록시 사용 비활성화 ```plaintext anydesk.exe --proxy --set-host never ``` 설정 **> 연결 > HTTP-Proxy**에서 프록시 모드를 **프록시 없음**으로 설정합니다. AnyDesk는 프록시를 통해 연결을 시도하지 않습니다. ### 프록시 자동 감지 ```plaintext anydesk.exe --proxy --set-host detect ``` 프록시 모드를 **프록시 감지로** 설정합니다. AnyDesk는 프록시 감지를 시도합니다. 아무것도 찾지 못하면 하나도 없이 진행됩니다. ### 수동 프록시 설정 ```plaintext anydesk.exe --proxy --set-host
[] [--reconnect] ``` **설정 > 연결 > HTTP-Proxy**에서 수동 프록시를 구성합니다. - `<proxy_type>`: `http`, `https`, 또는 `socks` - `<address>`: 프록시 서버 주소(IP 또는 URL) - `<port>`: 프록시에 연결하는 데 사용되는 포트 - `[+force-proxy]`: 프록시 시도, 실패 시 정상 연결로 대체(선택 사항) - `[-force-proxy]`: 강제 프록시; 프록시를 사용할 수 없는 경우 연결 끊기(선택 사항) - `[--reconnect]`: 연결을 다시 시작하여 새 설정을 적용합니다(선택 사항). ### 프록시 인증 사용 안 함 ```plaintext anydesk.exe --proxy --set-auth disable ``` 인증을 사용하지 않도록 설정합니다. **HTTP-Proxy** 인증을 인증 **필요 없음**으로 설정합니다. ### Windows 자격 증명 사용 ```plaintext anydesk.exe --proxy --set-auth auto ``` 프록시 인증(NTLM)에 Windows 계정 자격 증명을 사용합니다. **HTTP-Proxy** 인증을 **NTLM**으로 설정합니다. ### 사용자 이름 및 암호 지정 ```plaintext echo | anydesk.exe --proxy --set-auth simple ``` 인증에 구성된 사용자 이름과 비밀번호를 사용합니다. 프록시 인증 방법을 **사용자 이름 및 암호 설정**으로 설정합니다. 관리자와 고급 사용자가 명령줄 명령을 사용하여 설치, 구성 및 클라이언트 관리 작업을 자동화할 수 있는 도구입니다. 연결 시작, 종료 및 모니터링을 포함하여 원격 세션을 감독하고 제어하는 프로세스입니다. 상대방의 수동 승인 없이 원격 장치에 연결할 수 있는 기능으로, 비밀번호만으로 액세스할 수 있습니다. 로컬 장치와 원격 장치 간에 안전한 개인 연결을 생성하는 기본 제공 기능입니다. 두 네트워크의 다른 장치에 대한 액세스를 허용하지 않고 두 장치만 직접 연결하여 보안을 강화합니다.