Windows용 명령줄 인터페이스

Prev Next

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 <위치>

지정된 위치(예: C:\Program Files (x86)\AnyDesk)에 AnyDesk를 설치합니다.

--승리로 시작

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>

지정된 설정 섹션을 엽니다.

지원되는 매개변수: ui, , privacyrecordingprinterwolaliascapturelicensevideoaudioconnectionfile_transfersecurityabout

--관리자 설정:<viable_parameter>

전역 설정의 지정된 섹션을 엽니다.
지원되는 매개변수: capture, security, connection, recording

--면책 조항

사용자 지정 고지 사항 메시지를 표시합니다. 이 옵션을 사용하도록 설정된 사용자 지정 클라이언트에서만 작동합니다.

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_accessUnattended 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>

인증에 구성된 사용자 이름과 비밀번호를 사용합니다. 프록시 인증 방법을 사용자 이름 및 암호 설정으로 설정합니다.