다음을 통해 공유


pac auth

다양한 서비스에 인증하는 방법 관리

테넌트에 연결

pac auth create 명령을 사용하여 테넌트에 연결합니다. 실행 pac auth create 하면 컴퓨터에 인증 프로필이 만들어집니다. 여러 인증 프로필을 사용할 수 있습니다. 여러 테넌트에서 작업할 때는 여러 인증 프로필을 갖는 것이 흥미롭습니다. 예를 들어 회사에서 개발, 프로덕션 및 테스트를 위해 여러 테넌트를 사용하거나 여러 고객을 위해 일하는 컨설턴트인 경우입니다.

pac auth create 명령에는 몇 가지 유용한 매개 변수가 있습니다.

  • 매개 --environment 변수를 사용하면 올바른 환경에 자동으로 연결할 수 있습니다. 매개 변수를 --environment 생략하면 기본 환경에 연결되지만 매개 변수가 --environment 추가되면 다른 환경에 연결할 수 있습니다. 환경 ID, URL, 고유 이름 또는 부분 이름을 값으로 사용할 수 있습니다.

  • 대화형 환경을 사용할 수 없는 환경에서 매개 변수를 --deviceCode 추가하면 계속 연결할 수 있습니다. 예를 들어 GitHub Codespaces --deviceCode 에서 실행할 pac auth create때 매개 변수가 자동으로 추가됩니다.

Example

환경에 연결 HR-Dev 하려면 다음 예제를 사용할 수 있습니다.

pac auth create --environment "HR-Dev"

다른 인증 프로필로 전환

인증 프로필이 여러 개 있는 경우 pac 인증 목록pac auth select 명령을 사용하여 쉽게 전환할 수 있습니다.

pac auth list 명령은 컴퓨터의 모든 인증 프로필을 나열합니다. 이 pac auth select 명령은 다른 명령을 선택합니다.

pac auth list 본보기

모든 인증 프로필을 나열하려면 다음 예제를 사용합니다.

pac auth list

명령을 실행하면 pac auth list 모든 인증 프로필이 반환됩니다.

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

인덱스 값을 사용하여 다른 인증 프로필을 선택합니다.

pac auth select --index 2

Commands

Command Description
pac auth clear 이 컴퓨터에 저장된 모든 인증 프로필 지우기
pac auth create 이 컴퓨터에 인증 프로필 만들기 및 저장
pac auth delete 특정 인증 프로필 삭제
pac auth list 이 컴퓨터에 저장된 인증 프로필 나열
pac 인증 이름 기존 인증 프로필 이름 또는 이름 바꾸기
pac auth select 활성 상태여야 하는 인증 프로필 선택
pac auth update 기존 인증 프로필의 이름 또는 대상 환경 업데이트
pac auth who 현재 선택한 인증 프로필에 대한 정보 표시

pac auth clear

이 컴퓨터에 저장된 모든 인증 프로필 지우기

pac auth create

이 컴퓨터에 인증 프로필 만들기 및 저장

예시

다음 예제에서는 명령의 사용을 보여 줍니다 pac auth create .

기본 만들기

이 예제에서는 자격 증명을 묻는 메시지를 표시하고 자격 증명이 속한 테넌트에 연결합니다.

pac auth create

비고

Codespaces에서 Power Platform CLI를 실행하는 경우 디바이스 코드 로그인이 트리거됩니다.

환경 만들기

이 예제에서는 자격 증명을 묻는 메시지를 표시하고 사용자가 지정한 환경 ID를 사용하여 Power Platform 환경에 연결합니다.

pac auth create --environment < Your environment ID >

팁 (조언)

환경 ID를 찾으려면 다음을 수행합니다.

  1. Power Platform 관리 센터를 열고 연결할 환경을 선택합니다. 세부 정보 섹션에서 환경 ID를 찾습니다.

명명된 Create

이 예제에서는 테넌트에서 인증하고 이름을 MyOrg지정합니다.

pac auth create --name MyOrg

서비스 주체를 사용하여 명명된 Create

이 예제에서는 테넌트를 사용하여 인증하고, 이름을 MyOrg-SPN 지정하고, 서비스 주체를 사용하여 인증합니다. 사용자 환경에 서비스 주체를 추가하는 것을 잊지 마세요.

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

인증 만들기에 대한 선택적 매개 변수

--applicationId -id

선택 사항: 인증할 애플리케이션 ID입니다.

--azureDevOpsFederated -adof

(미리 보기) 서비스 주체 인증에 Azure DevOps Federation을 사용합니다. --tenant 및 --applicationId 인수 필요

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--certificateDiskPath -cdp

선택 사항: 인증할 인증서 디스크 경로

--certificatePassword -cp

선택 사항: 인증할 인증서 암호

--clientSecret -cs

선택 사항: 인증할 클라이언트 비밀

--cloud -ci

선택 사항: 인증할 클라우드 인스턴스

다음 값 중 하나를 사용합니다.

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

대화형 로그인에 Microsoft Entra ID 디바이스 코드 흐름을 사용합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--environment -env

기본 환경(ID, URL, 고유 이름 또는 부분 이름)입니다.

--githubFederated -ghf

(미리 보기) 서비스 주체 인증에 GitHub 페더레이션 사용 --tenant 및 --applicationId 인수 필요

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--managedIdentity -mi

Azure 관리 ID를 사용합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--name -n

이 인증 프로필에 지정하려는 이름(최대 30자)입니다.

참고: 이름의 길이는 1에서 30 사이여야 합니다.

--password -p

선택 사항: 인증할 암호

--tenant -t

애플리케이션 ID/클라이언트 암호 또는 애플리케이션 ID/클라이언트 인증서를 사용하는 경우 테넌트 ID입니다.

--url -u

사용되지 않음: 대신 사용합니다 --environment .

--username -un

선택 사항: 인증할 사용자 이름입니다. 지정하지 않으면 Microsoft Entra ID 대화 상자를 표시합니다.

비고

매개 변수의 cloud 경우 사용할 값은 다음과 같은 다른 일반적인 약어 또는 이름에 매핑됩니다.

  • GCC = UsGov
  • GCC High = UsGovHigh
  • DoD = UsGovDod

WSL2 인증 문제

WSL2(Linux용 Windows 하위 시스템 버전 2)를 사용하는 경우 WSL2 환경에 기본 브라우저가 설정되지 않은 경우와 같은 Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools 인증 문제가 있을 수 있습니다.

이 문제를 해결하려면 명령에 pac auth create --environment {env-id} --deviceCode플래그를 추가하여 디바이스 코드 인증을 --deviceCode 사용할 수 있습니다auth create. 인증 프로세스를 완료하려면 WSL2 외부의 브라우저에 코드를 입력해야 합니다.

pac auth delete

특정 인증 프로필 삭제

Example

pac auth delete --index 2

인증 삭제에 대한 선택적 매개 변수

--index -i

삭제할 프로필의 인덱스입니다.

참고: 값은 최소값이 1인 정수여야 합니다.

--name -n

활성 상태일 프로필의 이름입니다.

참고: 이름의 길이는 1에서 30 사이여야 합니다.

pac auth list

이 컴퓨터에 저장된 인증 프로필 나열

pac 인증 이름

기존 인증 프로필 이름 또는 이름 바꾸기

Example

다음 예제에서는 인증 프로필의 이름을 바꾸는 방법을 보여줍니다. 이 경우 인덱스 1이 있는 프로필의 이름이 'Contoso Dev'로 바뀝니다.

pac auth name --index 1 --name "Contoso Dev"

인증 이름에 필요한 매개 변수

--index -i

이름을 지정/이름을 바꿀 프로필의 인덱스입니다.

참고: 값은 최소값이 1인 정수여야 합니다.

--name -n

이 인증 프로필에 지정하려는 이름(최대 30자)입니다.

참고: 이름의 길이는 1에서 30 사이여야 합니다.

pac auth select

활성 상태여야 하는 인증 프로필 선택

Example

pac auth select --index 2

인증에 대한 선택적 매개 변수 선택

--index -i

활성화할 프로필의 인덱스입니다.

참고: 값은 최소값이 1인 정수여야 합니다.

--name -n

활성 상태일 프로필의 이름입니다.

참고: 이름의 길이는 1에서 30 사이여야 합니다.

pac auth update

기존 인증 프로필의 이름 또는 대상 환경 업데이트

예시

다음 예제에서는 pac auth update 명령의 사용을 보여 줍니다.

환경 URL을 사용하여 인증 프로필 업데이트

이 예제에서는 이름 Contoso Dev 및 환경 URL https://contosodev.crm.dynamics.com을 사용하여 인덱스 1로 인증 프로필을 업데이트하는 방법을 보여 줍니다.

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

환경 ID를 사용하여 인증 프로필 업데이트

이 예제에서는 환경 ID 00000000-0000-0000-0000-000000000000를 사용하여 인덱스 1로 인증 프로필을 업데이트하는 방법을 보여 줍니다.

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

인증 업데이트에 필요한 매개 변수

--index -i

이름을 지정/이름을 바꿀 프로필의 인덱스입니다.

참고: 값은 최소값이 1인 정수여야 합니다.

인증 업데이트에 대한 선택적 매개 변수

--environment -env

기본 환경(ID, URL, 고유 이름 또는 부분 이름)입니다.

--name -n

이 인증 프로필에 지정하려는 이름(최대 30자)입니다.

pac auth who

현재 선택한 인증 프로필에 대한 정보 표시

참고하십시오

Microsoft Power Platform CLI 명령 그룹
Microsoft Power Platform CLI 개요