pac auth

Zarządzanie sposobem uwierzytelniania w różnych usługach

Nawiązywanie połączenia z dzierżawą

Użyj polecenia pac auth create , aby nawiązać połączenie z dzierżawą. Uruchomienie pac auth create powoduje utworzenie profilu uwierzytelniania na maszynie. Dostępnych jest wiele profilów uwierzytelniania. Posiadanie wielu profilów uwierzytelniania jest interesujące podczas pracy z wieloma dzierżawami. Na przykład gdy firma korzysta z wielu dzierżaw (na potrzeby programowania, produkcji i testowania) lub gdy jesteś konsultantem, który pracuje dla wielu klientów.

Polecenie pac auth create ma kilka przydatnych parametrów:

• Parametr --environment umożliwia automatyczne łączenie się z odpowiednim środowiskiem. Jeśli pominięto --environment parametr, masz połączenie ze środowiskiem domyślnym, ale z dodanym do niego parametrem --environment możesz nawiązać połączenie z innym. Możesz użyć identyfikatora środowiska, adresu URL, unikatowej nazwy lub częściowej nazwy jako wartości.

• W środowiskach, w których nie masz możliwości korzystania ze środowiska interaktywnego, dodanie parametru --deviceCode gwarantuje, że nadal można nawiązać połączenie. Na przykład w usłudze GitHub Codespaces parametr jest automatycznie dodawany podczas uruchamiania --deviceCode polecenia pac auth create.

Example

Aby nawiązać połączenie ze środowiskiem, możesz użyć następującego przykładu HR-Dev :

pac auth create --environment "HR-Dev"

Przełączanie do innego profilu uwierzytelniania

Jeśli masz wiele profilów uwierzytelniania, możesz łatwo przełączyć się przy użyciu listy uwierzytelniania pac i pac auth select poleceń.

Polecenie pac auth list wyświetla listę wszystkich profilów uwierzytelniania na maszynie. Polecenie pac auth select wybiera inne polecenie.

pac auth list Przykład

Aby wyświetlić listę wszystkich profilów uwierzytelniania, użyj następującego przykładu:

pac auth list

pac auth list Uruchomienie polecenia zwraca wszystkie profile uwierzytelniania:

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

Wybierz inny profil uwierzytelniania przy użyciu wartości indeksu.

pac auth select --index 2

Commands

pac auth clear

Wyczyść wszystkie profile uwierzytelniania przechowywane na tym komputerze

pac auth create

Tworzenie i przechowywanie profilów uwierzytelniania na tym komputerze

Przykłady

W poniższych przykładach pokazano użycie pac auth create polecenia .

• Tworzenie podstawowe
• Tworzenie środowiska
• Nazwane tworzenie
• Nazwane tworzenie za pomocą jednostki usługi

Tworzenie podstawowe

W tym przykładzie zostanie wyświetlony monit o podanie poświadczeń i nawiązanie połączenia z dzierżawą, do której należą poświadczenia.

pac auth create

Tworzenie środowiska

W tym przykładzie zostanie wyświetlony monit o podanie poświadczeń i nawiązanie połączenia ze środowiskiem platformy Power Platform z określonym identyfikatorem środowiska.

pac auth create --environment < Your environment ID >

Nazwane tworzenie

Ten przykład uwierzytelnia się w dzierżawie i nadaje mu nazwę MyOrg.

pac auth create --name MyOrg

Nazwane tworzenie za pomocą jednostki usługi

Ten przykład uwierzytelnia się w dzierżawie, nadaje jej nazwę MyOrg-SPN i używa jednostki usługi do tego celu. Nie zapomnij dodać jednostki usługi do środowiska.

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

Opcjonalne parametry tworzenia uwierzytelniania

--applicationId -id

Opcjonalnie: identyfikator aplikacji do uwierzytelniania.

--azureDevOpsFederated -adof

(Wersja zapoznawcza) Użyj federacji usługi Azure DevOps na potrzeby uwierzytelniania jednostki usługi; wymaga argumentów --tenant i --applicationId

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--certificateDiskPath -cdp

Opcjonalnie: ścieżka dysku certyfikatu do uwierzytelniania za pomocą polecenia

--certificatePassword -cp

Opcjonalnie: hasło certyfikatu do uwierzytelniania za pomocą polecenia

--clientSecret -cs

Opcjonalnie: klucz tajny klienta do uwierzytelniania za pomocą polecenia

--cloud -ci

Opcjonalnie: wystąpienie chmury do uwierzytelniania za pomocą polecenia

Użyj jednej z następujących wartości:

• Public
• UsGov
• UsGovHigh
• UsGovDod
• China

--deviceCode -dc

Użyj przepływu kodu urządzenia Entra ID firmy Microsoft na potrzeby logowania interakcyjnego.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--environment -env

Środowisko domyślne (identyfikator, adres URL, unikatowa nazwa lub nazwa częściowa).

--githubFederated -ghf

(Wersja zapoznawcza) Użyj usługi GitHub Federation dla uwierzytelniania jednostki usługi; wymaga argumentów --tenant i --applicationId

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--managedIdentity -mi

Użyj tożsamości zarządzanej platformy Azure.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--name -n

Nazwa, którą chcesz nadać temu profilowi uwierzytelniania (maksymalnie 30 znaków).

Uwaga: długość nazwy powinna wynosić od 1 do 30

--password -p

Opcjonalnie: hasło do uwierzytelniania za pomocą polecenia

--tenant -t

Identyfikator dzierżawy, jeśli używasz identyfikatora aplikacji/klucza tajnego klienta lub identyfikatora aplikacji/certyfikatu klienta.

--url -u

Przestarzałe: zamiast tego użyj polecenia --environment .

--username -un

Opcjonalnie: nazwa użytkownika do uwierzytelnienia przy użyciu; wyświetla okno dialogowe Identyfikator entra firmy Microsoft, jeśli nie zostanie określone.

Uwagi

Dla parametru cloud wartości, które mają być używane do mapowania na te inne typowe akronimy lub nazwy:

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

Problemy z uwierzytelnianiem WSL2

W przypadku korzystania z podsystemu Windows dla systemu Linux w wersji 2 (WSL2) mogą wystąpić problemy z uwierzytelnianiem, takie jak Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools brak domyślnej przeglądarki ustawionej w środowisku WSL2.

Aby obejść ten problem, możesz użyć uwierzytelniania kodu urządzenia, dodając flagę --deviceCode do polecenia auth create : pac auth create --environment {env-id} --deviceCode. Aby ukończyć proces uwierzytelniania, musisz wprowadzić kod w przeglądarce spoza programu WSL2.

pac auth delete

Usuwanie określonego profilu uwierzytelniania

Example

pac auth delete --index 2

Opcjonalne parametry usuwania uwierzytelniania

--index -i

Indeks profilu, który ma zostać usunięty

Uwaga: Wartość musi być liczbą całkowitą z minimalną wartością 1.

--name -n

Nazwa profilu, który ma być aktywny

Uwaga: długość nazwy powinna wynosić od 1 do 30

lista uwierzytelniania pac

Wyświetlanie listy profilów uwierzytelniania przechowywanych na tym komputerze

nazwa uwierzytelniania pac

Nazwa lub zmiana nazwy istniejącego profilu uwierzytelniania

Example

W poniższym przykładzie pokazano, jak zmienić nazwę profilu uwierzytelniania. W takim przypadku nazwa profilu z indeksem 1 zostanie zmieniona na "Contoso Dev".

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

Wymagane parametry dla nazwy uwierzytelniania

--index -i

Indeks profilu, którego nazwa/nazwa ma zostać zmieniona

Uwaga: Wartość musi być liczbą całkowitą z minimalną wartością 1.

--name -n

Nazwa, którą chcesz nadać temu profilowi uwierzytelniania (maksymalnie 30 znaków).

Uwaga: długość nazwy powinna wynosić od 1 do 30

pac auth select

Wybierz, który profil uwierzytelniania powinien być aktywny

Example

pac auth select --index 2

Opcjonalne parametry dla wyboru uwierzytelniania

--index -i

Indeks profilu, który ma być aktywny.

Uwaga: Wartość musi być liczbą całkowitą z minimalną wartością 1.

--name -n

Nazwa profilu, który ma być aktywny

Uwaga: długość nazwy powinna wynosić od 1 do 30

pac auth update

Aktualizowanie nazwy lub środowiska docelowego istniejącego profilu uwierzytelniania

Przykłady

W poniższych przykładach pokazano użycie polecenia pac auth update.

• Aktualizowanie profilu uwierzytelniania przy użyciu adresu URL środowiska
• Aktualizowanie profilu uwierzytelniania przy użyciu identyfikatora środowiska

Aktualizowanie profilu uwierzytelniania przy użyciu adresu URL środowiska

W tym przykładzie pokazano, jak zaktualizować profil uwierzytelniania za pomocą indeksu 1 o nazwie Contoso Dev i adresie URL https://contosodev.crm.dynamics.comśrodowiska .

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

Aktualizowanie profilu uwierzytelniania przy użyciu identyfikatora środowiska

W tym przykładzie pokazano, jak zaktualizować profil uwierzytelniania za pomocą indeksu 1 przy użyciu identyfikatora 00000000-0000-0000-0000-000000000000środowiska .

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

Wymagane parametry aktualizacji uwierzytelniania

--index -i

Indeks profilu, którego nazwa/nazwa ma zostać zmieniona

Uwaga: Wartość musi być liczbą całkowitą z minimalną wartością 1.

Opcjonalne parametry aktualizacji uwierzytelniania

--environment -env

Środowisko domyślne (identyfikator, adres URL, unikatowa nazwa lub nazwa częściowa).

--name -n

Nazwa, którą chcesz nadać temu profilowi uwierzytelniania (maksymalnie 30 znaków).

pac auth, kto

Wyświetlanie informacji o aktualnie wybranym profilu uwierzytelniania

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform