AnyDesk 명령줄 인터페이스 (CLI)를 사용하면 관리자와 고급 사용자가 설치, 구성, 클라이언트 및 세션 관리, 네트워크 설정을 자동화할 수 있습니다. 이 문서에서는 Windows 명령 프롬프트 또는 배치 파일과 같은 스크립트 내에서 AnyDesk 명령을 사용하여 배포 및 관리를 간소화하는 방법을 설명합니다.
🚨 중요하다모든 명령은 있는 디렉토리
AnyDesk.exe
에서 실행하거나 전체 실행 가능 경로를 지정해야 합니다.
AnyDesk 실행 파일의 위치는 클라이언트 유형에 따라 다릅니다.
anydesk.com에서 다운로드한 표준 클라이언트 는 일반적으로 다음에 설치됩니다.
C:\Program Files (x86)\AnyDesk\AnyDesk.exe
my.anydesk.com를 통해 생성된 사용자 지정 클라이언트는 일반적으로 다음과 같이 설치됩니다.
C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
는<prefix>
계정의 고유 식별자입니다. 빌드 탭my.anydesk > 찾을 수 > 일반 섹션에서 원하는 빌드 >를 선택하고 접두사 필드를 선택합니다.
설치
이 섹션에서는 명령줄을 사용하여 AnyDesk Windows 클라이언트를 설치하거나 업데이트하는 방법에 대한 지침을 제공합니다. 스크립트, 시스템 배포 프로세스 또는 수동 설정 중에 이러한 명령을 사용할 수 있습니다. 설치 매개변수를 사용하면 바로가기 생성, 자동 모드 및 업데이트 기본 설정과 같은 특정 설치 동작을 정의할 수 있습니다.
설치 명령
CLI를 사용하여 AnyDesk를 설치하거나 업데이트하려면 다음 명령 형식을 사용하십시오.
anydesk.exe --install <location> <additional_parameters>
예를 들어:
anydesk.exe --install “C:\Program Files (x86)\AnyDesk” --start-with-win --create-desktop-icon
MSI 기반 배포의 경우:
anydesk.msi (optional: INSTALL="<location>")
설치 매개변수
매개 변수 | 묘사 |
--install <위치> | 지정된 위치(예: |
--승리로 시작 | Windows에서 자동으로 실행되도록 AnyDesk를 구성합니다. |
--만들기 단축키 | 시작 메뉴 바로 가기를 추가합니다. |
--데스크탑 만들기 아이콘 | 바탕 화면 단축키를 추가합니다. |
--제거 우선 | 새 버전을 설치하기 전에 현재 버전을 제거합니다. 수동 업데이트에 유용합니다. |
--조용하다 | 사용자 인터페이스 및 오류 프롬프트 없이 설치를 실행합니다. |
--수동으로 업데이트 | 수동 업데이트를 사용하도록 설정합니다(사용자 지정 클라이언트의 기본값). |
--업데이트 비활성화 | AnyDesk 업데이트를 비활성화합니다. |
--업데이트 자동 | 자동 업데이트를 사용하도록 설정합니다(표준 클라이언트의 경우 기본값, 사용자 지정 클라이언트의 경우 사용할 수 없음) |
AnyDesk 클라이언트
AnyDesk 실행 파일(anydesk.exe
)은 관리자가 클라이언트를 제어하고 구성할 수 있는 광범위한 명령을 제공합니다. 이러한 명령은 개별적으로 또는 자동화 스크립트 내에서 사용하여 여러 시스템에서 관리 작업을 간소화할 수 있습니다.
클라이언트 명령
아래 예제에서는 라이센스 키 등록 또는 무인 액세스 암호 설정과 같은 키 클라이언트 명령을 사용하는 방법을 보여줍니다. 이러한 명령은 초기 설정 중 또는 클라이언트 구성을 자동화할 때 자주 사용됩니다.
명령 | 묘사 |
anydesk.exe <매개 변수> | 사용 가능한 옵션의 전체 목록은 Client command parameters를 참조하십시오. |
'에코 <license_key> "| anydesk.exe --등록 라이센스 | 지정된 라이센스 키를 등록합니다. 관리자 권한이 필요합니다. |
'에코 <my_password> "| anydesk.exe --비밀번호 설정 | 무인 액세스에 대해 지정된 암호를 설정합니다. |
클라이언트 명령 매개변수
이 표에는 AnyDesk 클라이언트에 사용할 수 있는 개별 명령줄 매개변수가 나열되어 있습니다. 이러한 매개 변수는 클라이언트를 직접 구성하거나 제어하는 데 사용할 anydesk.exe
수 있으며 일반적으로 스크립트 또는 관리 설정에서 사용됩니다.
매개 변수 | 묘사 |
--제거 | 그래픽 프롬프트로 AnyDesk를 제거합니다. |
--제거하다 | 프롬프트나 UI 없이 AnyDesk를 자동으로 제거합니다. |
--시작하다 | AnyDesk 백그라운드 서비스를 시작합니다. |
--서비스 중지 | AnyDesk 백그라운드 서비스를 중지합니다. |
--다시 시작 서비스 | AnyDesk 백그라운드 서비스를 다시 시작합니다. |
--비밀번호 제거 | 무인 액세스 암호를 삭제합니다(관리자 권한 필요). 메모: 이렇게 하면 사용자 지정 클라이언트에서 사전 설정된 암호를 제거할 수 없습니다. |
--라이센스 제거 | 클라이언트에서 라이센스 키를 제거합니다. 메모: 계정을 통해 로그인한 사용자는 로그아웃되지 않습니다. |
--별칭 가져오기 | AnyDesk 별칭을 표시합니다. 일반적으로 스크립트에서 사용됩니다. |
--아이디 얻기 | AnyDesk ID를 표시합니다. 일반적으로 스크립트에서 사용됩니다. |
--상태 가져오기 | 클라이언트의 온라인 상태를 표시합니다. |
--버전 | 설치된 AnyDesk 버전을 표시합니다. |
--설정 | 기본(로컬) 설정 페이지를 엽니다. |
--관리자 설정 | 전역(관리자 수준) 설정 페이지를 엽니다. |
--설정:<viable_parameter> | 지정된 설정 섹션을 엽니다. 지원되는 매개변수: |
--관리자 설정:<viable_parameter> | 전역 설정의 지정된 섹션을 엽니다. |
--면책 조항 | 사용자 지정 고지 사항 메시지를 표시합니다. 이 옵션을 사용하도록 설정된 사용자 지정 클라이언트에서만 작동합니다. |
AnyDesk ID를 얻는 배치 스크립트의 예:
@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 이상에서 지원됩니다.
권한 프로필 만들기
anydesk.exe --add-profile <name> +<permission> +<permission> ...
라는 새 <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
무인 액세스 암호로 프로필 만들기
echo <password> | anydesk.exe --add-profile <name> +<permission> +<permission> ...
지정된 무인 액세스 암호로 명명된 <name>
권한 프로필을 만듭니다. 권한은 위와 동일한 방식으로 정의해야 합니다.
기존 프로필에 대한 암호 설정
echo <password> | anydesk.exe --set-password <profile>
지정된 프로필에 대한 무인 액세스 암호를 할당하거나 업데이트합니다.
사용자 지정 프로필의 경우: 권한 프로필 이름을 사용합니다.
기본 프로필의 경우 다음을 사용합니다.
_default
–기본값_full_access
– 전체 액세스_screen_sharing
– 화면 공유_unattended_access
– Unattended Access
프로필에서 비밀번호 제거
anydesk.exe --remove-password <profile>
지정된 프로필에서 무인 액세스 암호를 제거합니다.
💡 메모
이 명령은 사용자 지정 클라이언트 구성에서 사전 설정된 암호를 제거할 수 없습니다.
명령줄을 통해 세션 시작
실행 파일을 사용하여 명령줄에서 직접 원격 세션을 시작할 수 있습니다 anydesk.exe
.
연결 명령
이는 AnyDesk를 스크립트, 관리 도구 또는 자동화 프로세스와 통합하는 데 유용할 수 있습니다.
클라이언트에 연결
anydesk.exe <ID/Alias> <additional parameters>
지정된 AnyDesk ID 또는 별칭에 대한 원격 세션을 시작합니다.
<ID_or_Alias>
- 원격 클라이언트의 AnyDesk 주소입니다.<additional_parameters>
- 세션을 사용자 정의하는 선택적 매개변수입니다. 추가 매개 변수는 Optional session parameters를 참조하십시오.
암호를 사용하여 연결
echo <password> | anydesk.exe <ID/Alias> --with-password
지정된 클라이언트에 대한 세션을 시작하고 무인 액세스에 대해 지정된 암호를 제출합니다.
선택적 세션 매개 변수
세션 명령에 다음 매개 변수를 추가하여 세션 시작 방법을 수정할 수 있습니다.
명령 | 묘사 |
--파일 전송 | 파일 전송 세션을 시작합니다. |
--전체 화면 | 전체 화면 모드에서 세션을 시작합니다. |
--평야 | 테두리와 메뉴 옵션이 없는 창에서 세션을 시작합니다. |
프록시 명령
명령줄 매개변수를 사용하여 AnyDesk의 HTTP 프록시 설정을 구성할 수 있습니다. 이는 엄격한 네트워크 정책이 있거나 프록시 인증이 필요한 환경에 특히 유용합니다.
🦉 프록시 설정에 대한 자세한 내용은this article를 참조하십시오 .
프록시 사용 비활성화
anydesk.exe --proxy --set-host never
설정 > 연결 > HTTP-Proxy에서 프록시 모드를 프록시 없음으로 설정합니다. AnyDesk는 프록시를 통해 연결을 시도하지 않습니다.
프록시 자동 감지
anydesk.exe --proxy --set-host detect
프록시 모드를 프록시 감지로 설정합니다. AnyDesk는 프록시 감지를 시도합니다. 아무것도 찾지 못하면 하나도 없이 진행됩니다.
수동 프록시 설정
anydesk.exe --proxy --set-host <proxy_type> <address> <port> [<force_proxy>] [--reconnect]
설정 > 연결 > HTTP-Proxy에서 수동 프록시를 구성합니다.
<proxy_type>
:http
,https
, 또는socks
<address>
: 프록시 서버 주소(IP 또는 URL)<port>
: 프록시에 연결하는 데 사용되는 포트[+force-proxy]
: 프록시 시도, 실패 시 정상 연결로 대체(선택 사항)[-force-proxy]
: 강제 프록시; 프록시를 사용할 수 없는 경우 연결 끊기(선택 사항)[--reconnect]
: 연결을 다시 시작하여 새 설정을 적용합니다(선택 사항).
프록시 인증 사용 안 함
anydesk.exe --proxy --set-auth disable
인증을 사용하지 않도록 설정합니다. HTTP-Proxy 인증을 인증 필요 없음으로 설정합니다.
Windows 자격 증명 사용
anydesk.exe --proxy --set-auth auto
프록시 인증(NTLM)에 Windows 계정 자격 증명을 사용합니다. HTTP-Proxy 인증을 NTLM으로 설정합니다.
사용자 이름 및 암호 지정
echo <password> | anydesk.exe --proxy --set-auth simple <username>
인증에 구성된 사용자 이름과 비밀번호를 사용합니다. 프록시 인증 방법을 사용자 이름 및 암호 설정으로 설정합니다.