Skip to main content
이 가이드는 Mac 컴퓨터에 적용됩니다

​
Iru Agent CLI 정보

Iru Agent는 관리자가 기기 플릿에 대해 추가적인 제어와 정보를 얻을 수 있는 강력한 Terminal 명령 모음을 제공합니다. 일부 명령은 Terminal을 사용하여 기기에서 로컬로만 실행할 수 있지만, 다른 명령은 유연성을 높이기 위해 Custom Script Library Item을 통해 배포할 수 있습니다.
2026년 4월 8일부터 앱 브랜딩이 Kandji 에서 Iru 로 업데이트되었습니다. Agent 앱 이름이 Kandji Agent에서 Iru Agent로 변경되었습니다. 이전 앱 이름을 여전히 참조하는 스크립트, 자동화 및 유틸리티를 업데이트하세요.

​
로컬 전용 명령

다음 명령은 기기의 Terminal에서 직접 실행해야 합니다. Custom Script 또는 Custom App Library Item을 통해 배포할 수 없습니다.

​
대화형 모드(TUI)

하위 명령과 옵션 없이 sudo iru를 실행하면 터미널 사용자 인터페이스(TUI)가 열립니다. 이는 Terminal의 전체 화면 메뉴 기반 흐름으로, 전체 명령과 플래그를 입력하지 않고도 일반적인 에이전트 작업을 찾아보고 실행할 수 있습니다.
Terminal

​
Run

에이전트가 즉시 실행되고 체크인합니다. 일반적으로 에이전트는 15분마다 체크인합니다. 인터넷 연결이 없으면 에이전트는 오프라인 모드로 실행됩니다.
Terminal
지난 24시간 이내에 이미 실행된 경우에도 일일 에이전트 작업을 강제로 실행하려면 --reset-daily를 추가합니다.
  • Blueprint Parameters: 지난 24시간 이내에 이미 실행된 경우에도 일일 Parameters가 실행됩니다.
  • 사용자 지정 스크립트: 매 체크인마다 실행되거나 지속적으로 적용되는 스크립트뿐만 아니라 빈도가 일일인 Custom Scripts도 실행됩니다.
  • 앱 인벤토리: 하루 한 번의 인벤토리 일정을 무시하고 애플리케이션 인벤토리(MDM 명령 포함)를 수집합니다.
Terminal

​
일일 MDM 인벤토리 업데이트 실행

에이전트가 MDM 서버에 Apple Business 또는 Apple School Manager의 Apps & Books 검증 및 특정 기기 정보 쿼리와 같은 일일 MDM 명령을 시작하도록 요청합니다.
Terminal

​
앱 수집

Mac에서 전체 애플리케이션 인벤토리를 수집합니다.
Terminal

​
Library Items 실행

실행할 Library Items를 확인합니다.
Terminal
예약되지 않은 경우에도 단일 Library Item을 강제로 실행하려면 --item과 --reset-daily(-F와 동일)를 함께 사용합니다.
Terminal
사용 가능한 library 명령 옵션:

​
Iru Agent 로그 출력

통합 로깅 시스템에서 Iru Agent 하위 시스템의 로그 항목을 출력합니다. --last 옵션은 필수이며, 로그를 출력할 이전 시간(초)을 지정합니다. <seconds>를 300과 같은 숫자로 바꿉니다. (실제로 표시되는 결과는 사용 가능한 통합 로그 저장 공간에 따라 제한됩니다.) 외부 로그 파일에 저장하려면 >를 사용하여 명령의 출력을 리디렉션합니다.
Terminal
사용 가능한 logs 명령 옵션:
통합 로깅은 제품 브랜딩과 별개입니다. 아래 예시와 같이 Mac의 하위 시스템 식별자는 log show 조건자와 log config --subsystem에서 여전히 io.kandji 접두사를 사용합니다. 명령이 시스템에 기록된 내용과 일치하도록 해당 문자열을 사용하세요.
로깅 하위 시스템 섹션에 나열된 하위 시스템에 대해 디버그 로깅을 활성화합니다.
Terminal
디버그 로깅 명령 사용 예시입니다.
Terminal
로깅 하위 시스템 Iru Agent에서 사용할 수 있는 로깅 하위 시스템은 세분화되고 대상이 지정된 로깅을 제공합니다. 하위 시스템 조건자 로그 명령입니다.
Terminal
사용 가능한 조건자 로그 명령 옵션: 옵션이 포함된 하위 시스템 조건자 로그 명령입니다.
Terminal
사용 가능한 로깅 하위 시스템:
  • io.kandji.beekeeper
  • io.kandji.cli
  • io.kandji.daemon
  • io.kandji.installer
  • io.kandji.library-manager
  • io.kandji.menu
  • io.kandji.passport
  • io.kandji.parameter-agent
  • io.kandji.self-service
  • io.kandji.liftoff

​
EDR

격리된 파일을 나열합니다.
Terminal
격리된 파일을 삭제합니다.
Terminal

​
스크립트 가능 명령

이 명령은 Custom Script 또는 Custom App Library Item을 통해 실행할 수 있습니다. Mac의 Terminal에서 로컬로 실행할 수도 있습니다.
Custom Script Library Item 내에서와 같이 아래의 스크립트 가능 옵션을 사용할 때는 sudo iru를 바이너리의 전체 경로인 /usr/local/bin/iru로 바꿔야 합니다

​
Reboot

이 옵션은 스크립트 워크플로에서 Iru Agent와 메뉴 막대 애플리케이션을 활용하여 강제로 재부팅하는 데 사용할 수 있습니다. FileVault 활성화 또는 Managed OS 업그레이드 중에 강제되는 재부팅과 시각적으로 유사합니다. 로그인한 사용자에게 카운트다운 타이머를 표시하여 재시작을 시작합니다. 지연 시간을 지정하지 않으면 기본값 1800(30분)이 사용됩니다. 로그인한 사용자가 없으면 지연 시간이 무시되고 Mac이 즉시 재시작됩니다. <seconds>를 카운트다운 길이(초)로 바꿉니다(예: 5분은 300).
Terminal
사용자에게 연기 옵션을 제공하지 않고 강제로 재시작합니다.
Terminal

​
Dock

이 옵션은 스크립트 워크플로에서 현재 로그인한 사용자의 macOS Dock 끝에 항목을 추가하거나 macOS Dock에서 항목을 제거하는 데 사용할 수 있습니다. 번들 식별자가 가리키는 애플리케이션은 /Applications 폴더에 있어야 합니다. 선택적으로 —all 옵션을 지정하면 모든 사용자 계정의 Dock 끝에 아이콘이 추가됩니다.
Terminal
여러 옵션을 한 번에 사용하는 경우 아래 예시와 같이 단일 명령을 사용하고 따옴표와 공백으로 옵션을 구분합니다.
Terminal

​
Alert

이 명령은 스크립트 워크플로에서 사용자에게 경고를 표시하는 데 사용할 수 있습니다.
Terminal
아래에 설명된 여러 옵션이 있습니다. 다음은 경고의 기본 명령과 macOS Tahoe에서의 결과 화면 예시입니다.
Terminal
display-alert 명령 실행 후 Low Disk Space 제목, 경고 메시지, Help 버튼 및 OK가 표시된 macOS Tahoe의 경고 대화 상자

​
Submit Diagnostics

Iru Endpoint에 진단 정보를 제출합니다. Iru 메뉴에서 사용할 수 있는 작업 메뉴(톱니바퀴) 항목과 동일합니다.
Terminal
사용 가능한 submit-diagnostics 명령 옵션:

​
Version

설치된 Iru Agent 버전을 표시합니다.
Terminal

​
Help

도움말 텍스트를 표시합니다.
Terminal