다음을 통해 공유


URL 또는 데스크톱 바로 가기를 통해 데스크톱 흐름 실행

콘솔, 흐름 디자이너 및 클라우드 흐름을 통해 흐름을 트리거하는 것과 별도로 Power Automate를 사용하면 실행 URL 및 데스크톱 바로 가기를 사용하여 데스크톱 흐름을 실행할 수 있습니다.

URL을 사용하여 브라우저, Windows 실행 애플리케이션, 명령 프롬프트Windows 작업 스케줄러와 같은 다양한 소스를 통해 데스크톱 흐름을 트리거할 수 있습니다. 또는 데스크톱 바로 가기를 만들고 데스크톱 흐름을 직접 실행할 수 있습니다.

트리거된 흐름에 입력 변수가 필요한 경우 콘솔에서 적절한 값을 입력하도록 요청합니다.

기본적으로, Power Automate는 항상 URL 또는 데스크톱 바로 가기를 통해 데스크톱 흐름의 트리거를 확인하라는 메시지를 표시합니다. 이 기능을 비활성화하려면 콘솔 설정으로 이동하여 외부에서 흐름을 호출할 때 확인 대화 상자 표시를 비활성화하거나 적절한 Windows 레지스트리 항목을 수정합니다.

경고

확인 대화 상자를 비활성화하면 악의적인 행위자가 공유하는 의심스러운 흐름을 예고 없이 실행할 수 있기 때문에 보안 위협이 됩니다.

콘솔 설정에서 흐름을 외부에서 호출할 때 확인 대화 상자 표시 옵션의 스크린샷.

전제 조건

  • 데스크톱용 Power Automate가 컴퓨터에 설치되어 있어야 합니다.
  • 사용자가 로그인되어 있어야 합니다.
  • 사용자에게는 Power Automate Premium 플랜이 필요하거나 종량제 환경에 대한 액세스가 필요합니다.

데스크톱 바로 가기 만들기

데스크톱 흐름에 대한 바로 가기를 만들려면 콘솔에서 해당 이름을 마우스 오른쪽 버튼으로 클릭하고 데스크톱 바로 가기 만들기를 선택합니다. 모든 바로 가기는 데스크톱 폴더에 자동으로 생성되지만 컴퓨터의 모든 폴더로 이동할 수 있습니다.

데스크톱 바로 가기 만들기 옵션의 스크린샷.

실행 URL 만들기

중요

흐름이 이미 실행 중인 경우 URL이 호출될 때 다시 실행되지 않습니다.

데스크톱 흐름을 트리거하는 URL을 생성하려면 다음 형식 중 하나를 사용하십시오.

"ms-powerautomate:/console/flow/run?workflowName=[workflowName]"
"ms-powerautomate:/console/flow/run?workflowId=[workflowId]"
"ms-powerautomate:/console/flow/run?environmentId=[environmentId]&workflowId=[workflowId]"
"ms-powerautomate:/console/flow/run?environmentId=[environmentId]&workflowName=[workflowIName]"

노트

데스크톱 흐름의 속성 섹션에서 환경 및 흐름 ID로 구성된 자동으로 생성된 실행 URL을 찾을 수 있습니다. 흐름 속성에 대한 자세한 정보는 데스크톱 흐름 속성에서 확인할 수 있습니다.

처음 두 형식은 특정 환경을 정의하지 않으므로 Power Automate은 현재 선택된 콘솔 환경을 자동으로 사용합니다. 흐름 ID 또는 흐름 이름이 지정되지 않은 경우 명령이 무시됩니다.

콘솔이 URL에 지정된 환경이 아닌 다른 환경으로 설정되면 콘솔 환경이 자동으로 변경됩니다.

환경 및 데스크톱 흐름 ID 찾기

환경의 ID를 찾으려면 Power Automate 포털로 이동하여 원하는 환경을 선택합니다. 그런 다음 내 흐름 탭을 클릭하고 주소 표시줄에서 환경 ID를 복사합니다.

주소 표시줄에 있는 환경 ID의 스크린샷.

데스크톱 흐름의 ID를 찾으려면 Power Automate 콘솔을 시작하고 적절한 흐름을 선택하거나 마우스 오른쪽 버튼으로 클릭하고 속성을 선택합니다.

데스크톱 흐름의 세부 정보 스크린샷.

실행 URL에 선택적 매개 변수 추가

필수 입력 매개 변수 외에도 실행 URL에 선택적 매개 변수를 추가할 수 있습니다.

실행 URL에 흐름 입력 변수 추가

inputArguments 매개 변수를 실행 URL에 추가하여 흐름 입력을 구성합니다.

inputArguments 매개 변수에 흐름의 모든 입력 변수가 포함되어 있으면 Power Automate 콘솔은 흐름 실행 중에 사용자 입력을 요청하지 않습니다.

inputArguments 매개 변수가 포함된 URL은 다음과 같은 구조를 가져야 합니다. 매개 변수는 이전에 언급된 URL에 추가할 수 있습니다.

중요

JSON 문자열의 모든 특수 문자는 이스케이프 처리되어야 합니다. 예를 들어 모든 큰따옴표는 백슬래시로 이스케이프 처리되어야 합니다.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&inputArguments={\"[External name 1]\": [Value 1],\"[External name 2]\": [Value 2]}"

예를 들어 아래 실행 URL은 텍스트, 숫자 및 부울 입력을 사용하여 데스크톱 흐름을 호출합니다.

"ms-powerautomate:/console/flow/run?&workflowid=dfd0c814-2c30-4cd8-849d-a4b2d2f4f33b&inputArguments={\"NewInput\": \"Hello\", \"NewInput2\": 123, \"NewInput3\": true}"

노트

  • 텍스트, 숫자 및 부울 데이터 유형만 지원됩니다.
  • 부울 값은 대소문자를 구분하며 값은 true 또는 false일 수 있습니다.
  • inputArguments 매개 변수에 포함되지 않은 추가 흐름 입력이 있는 경우 흐름 실행 중에 Power Automate 콘솔이 사용자 입력을 요청합니다.
  • 실행 URL을 호출하는 소스에는 허용되는 최대 문자 제한이 있을 수 있으며, 이로 인해 해당 제한을 초과하면 흐름이 실패하게 됩니다.

중요

  • 웹 브라우저를 통해 실행 URL을 트리거하려면 inputArguments 매개 변수의 JSON 문자열 값을 이스케이프 해제하고 URL 인코딩을 사용하여 문자를 유효한 ASCII 형식으로 변환합니다.
  • 큰따옴표 문자를 이스케이프 처리하려면 백슬래시를 제거하세요. 예: inputArguments={"NewInput": "Hello", "NewInput2": 123, "NewInput3": true}

현재 Windows 계정으로 자동 로그인

사용자 상호 작용 없이 현재 Windows에 로그인한 사용자로 Power Automate에 로그인하려면 실행 URL에 autologin 매개 변수를 추가합니다.

전제 조건으로 사용자는 로그아웃해야 하며 Power Automate가 컴퓨터에서 실행되고 있지 않아야 합니다.

중요

사용자가 UI를 통해 명시적으로 Power Automate에서 로그아웃한 경우 Power Automate는 사용자의 기본 설정을 존중하고 자동 로그인을 수행하지 않습니다.

autologin 매개 변수가 포함된 URL은 다음과 같은 구조를 가져야 합니다. 매개 변수는 이전에 언급된 URL에 추가할 수 있습니다.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&autologin=true"

URL을 통해 실행되는 데스크톱 흐름에 대한 로그 저장

실행 URL에 runId 매개 변수를 추가하여 데스크톱 흐름 로그에 대한 고유 GUID를 정의합니다.

Power Automate이 GUID를 사용하여 폴더를 만들고 그 안에 로그를 저장합니다. 로그는 C:\Users\[사용자 이름]\AppData\Local\Microsoft\Power Automate Desktop\Console\Scripts\[Flow ID]\Runs\[Run ID]에 저장

노트

GUID는 8자리 16진수 그룹 1개, 각각 4자리 그룹 3개, 12자리 그룹 1개로 구성된 128비트 값입니다(예: e6f82a20-47f7-4dd8-a97f-63df36797d0f).

runId 입력 매개 변수가 포함된 URL은 다음과 같은 구조를 가져야 합니다. 매개 변수는 이전에 언급된 URL에 추가할 수 있습니다.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&runId=[GUID]"

명령 프롬프트에서 실행 URL 사용

명령 프롬프트를 사용하여 흐름을 트리거하려면 다음 구문의 명령을 사용합니다(MSI 설치에 적용됨).

"C:\Program Files (x86)\Power Automate Desktop\PAD.Console.Host.exe" "ms-powerautomate:/console/flow/run?workflowName=[workflowName]"

노트

명령의 두 번째 부분을 이전에 제공된 URL 형식으로 바꿀 수 있습니다.

작업 스케줄러를 사용하여 자동으로 흐름 트리거

Windows의 작업 스케줄러 애플리케이션을 사용하여 흐름을 트리거하려면:

  1. 새 작업을 만들고 작업 만들기 대화 상자의 작업 탭으로 이동하여 새 작업을 추가합니다.

  2. 프로그램/스크립트 필드에 다음 값을 입력합니다.

    • MSI 설치의 경우:
    C:\Program Files (x86)\Power Automate Desktop\PAD.Console.Host.exe
    
    • Microsoft Store 설치의 경우:
    C:\WINDOWS\system32\WindowsPowerShell\v1.0\powershell.exe
    
  3. 인수 추가 필드에 다음 값을 입력합니다.

    • MSI 설치의 경우:
    ms-powerautomate:/console/flow/run?workflowName=[workflowName]
    
    • Microsoft Store 설치의 경우:
    -Command "Start-Process \"ms-powerautomate:/console/flow/run?workflowName=[workflowName]""
    

    노트

    주어진 인수를 이전에 제시된 URL 형식으로 바꿀 수 있습니다.