Aracılığıyla paylaş


pac auth

Çeşitli hizmetlerde kimlik doğrulama yönteminizi yönetme

Kiracınıza bağlanma

pac auth create Kiracınıza bağlanmak için komutunu kullanın. Çalıştırma pac auth create , makinenizde bir kimlik doğrulama profili oluşturur. Birden çok kimlik doğrulama profili kullanabilirsiniz. Birden çok kiracıyla çalışırken birden çok kimlik doğrulama profiline sahip olmak ilginçtir. Örneğin, şirketiniz birden çok kiracı kullandığında (geliştirme, üretim ve test için) veya birden çok müşteri için çalışan bir danışman olduğunuzda.

pac auth create Komutun birkaç yararlı parametresi vardır:

  • --environment parametresi, doğru ortama otomatik olarak bağlanmanızı sağlar. Parametresini --environment atlarsanız varsayılan ortama bağlanırsınız, ancak --environment parametresi eklendiğinde farklı bir ortama bağlanabilirsiniz. Değer olarak ortam kimliğini, url'yi, benzersiz adı veya kısmi adı kullanabilirsiniz.

  • Etkileşimli bir deneyim kullanma yeteneğine sahip olmadığınız ortamlarda, parametresini --deviceCode eklemek hala bağlanabildiğinizi sağlar. Örneğin, GitHub Codespaces içinde parametresini çalıştırdığınızda --deviceCodepac auth createotomatik olarak eklenir.

Example

Ortama bağlanmak için HR-Dev aşağıdaki örneği kullanabilirsiniz:

pac auth create --environment "HR-Dev"

Başka bir kimlik doğrulama profiline geçme

Birden çok kimlik doğrulama profiliniz olduğunda ve pac auth select komutlarını kullanarak pac auth list kolayca geçiş yapabilirsiniz.

komutu makinenizdeki pac auth list tüm kimlik doğrulama profillerini listeler. komutu pac auth select farklı bir komut seçer.

pac auth list Örnek

Tüm kimlik doğrulama profillerini listelemek için aşağıdaki örneği kullanın:

pac auth list

komutunu çalıştırmak pac auth list tüm kimlik doğrulama profillerini döndürür:

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

Dizin değerini kullanarak farklı bir kimlik doğrulama profili seçin.

pac auth select --index 2

Commands

Command Description
pac auth clear Bu bilgisayarda depolanan tüm kimlik doğrulama profillerini temizle
pac auth create Bu bilgisayarda kimlik doğrulama profilleri oluştur ve depola
pac auth delete Belirli bir kimlik doğrulama profilini silme
pac auth list Bu bilgisayarda depolanan kimlik doğrulama profillerini listele
pac auth name Mevcut kimlik doğrulama profilini adlandırma veya yeniden adlandırma
pac auth select Hangi kimlik doğrulama profilinin etkin olacağını seçin
pac auth update Mevcut kimlik doğrulama profilinin adını veya hedef ortamını güncelleştirme
pac auth who Seçili durumdaki kimlik doğrulama profili hakkındaki bilgileri görüntüleme

pac auth clear

Bu bilgisayarda depolanan tüm kimlik doğrulama profillerini temizle

pac auth create

Bu bilgisayarda kimlik doğrulama profilleri oluştur ve depola

Örnekler

Aşağıdaki örneklerde komutun kullanımı gösterilmektedir pac auth create .

Temel Oluşturma

Bu örnek sizden kimlik bilgilerini ister ve kimlik bilgilerinin ait olduğu kiracıya bağlanır.

pac auth create

Uyarı

Codespaces'ta Power Platform CLI çalıştırılırken bu işlem bir cihaz kodu oturum açma işlemini tetikler.

Ortam Oluşturma

Bu örnek sizden kimlik bilgilerini ister ve belirttiğiniz ortam kimliğiyle Power Platform ortamına bağlanır.

pac auth create --environment < Your environment ID >

Tavsiye

Ortam kimliğini bulmak için: Power Platform yönetim merkezini açın ve bağlanmak istediğiniz Ortamı seçin. Ayrıntılar bölümünde Ortam Kimliği'ni arayın

Adlandırılmış Oluştur

Bu örnek, kiracınızla kimlik doğrulaması yapar ve adını MyOrgverir.

pac auth create --name MyOrg

Hizmet Sorumlusu ile Oluşturma Adlı

Bu örnek kiracınızla kimlik doğrulaması yapar, adını MyOrg-SPN verir ve bunu yapmak için bir hizmet sorumlusu kullanır. Hizmet sorumlusunu ortamınıza eklemeyi unutmayın.

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

Azure Kimliği

Azure Kimliğini destekleyen bir ortamda (Azure Cloud Shell, Yönetilen Kimlikli Azure VM veya Azure Hesabı uzantısıyla Visual Studio Code gibi) çalışırken, Azure Kimliğini kullanarak kimlik doğrulaması yapmak için bayrağını kullanabilirsiniz --managedIdentity . PAC CLI, önceden yapılandırılmış, önceden yapılandırılmış bir kimlik bilgileri zinciri olan Varsayılan Azure Kimlik Bilgileri'ni kullanır.

Varsayılan Azure Kimlik Bilgileri, en yaygın kimlik doğrulama akışları ve geliştirici araçlarının yanı sıra birçok ortamı destekleyecek şekilde tasarlanmıştır. Varsayılan Azure Kimlik Bilgileri belgelerinde açıklandığı gibi ortam değişkenlerini ayarlayarak davranışı özelleştirebilirsiniz. Örneğin, kullanıcı tarafından atanan yönetilen kimliği kullanarak kimlik doğrulaması yapmak için ortam değişkenini AZURE_CLIENT_ID kullanıcı tarafından atanan yönetilen kimliğin istemci kimliğine ayarlayın. Uygulama ortamı değişkenlerini ayarlama bölümünde daha fazla ayrıntıya bakın.

için İsteğe Bağlı Parametreler auth create

--applicationId -id

İsteğe bağlı: Kimlik doğrulaması için uygulama kimliği.

--azureDevOpsFederated -adof

(Önizleme) Hizmet Sorumlusu Kimlik Doğrulaması için Azure DevOps Federasyonu'yu kullanma; --tenant ve --applicationId bağımsız değişkenleri gerektirir

Bu parametre için değer gerekmez. Bu bir anahtar.

--certificateDiskPath -cdp

İsteğe bağlı: Kimlik doğrulaması için sertifika disk yolu

--certificatePassword -cp

İsteğe bağlı: Kimlik doğrulaması için sertifika parolası

--clientSecret -cs

İsteğe bağlı: Kimlik doğrulaması için istemci gizli dizisi

--cloud -ci

İsteğe bağlı: Kimlik doğrulaması için bulut örneği

Şu değerlerden birini kullanın:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

Etkileşimli oturum açmak için Microsoft Entra ID Cihaz Kodu akışını kullanın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--environment -env

Varsayılan ortam (kimlik, url, benzersiz ad veya kısmi ad).

--githubFederated -ghf

(Önizleme) Hizmet Sorumlusu Kimlik Doğrulaması için GitHub Federasyonu kullanma; --tenant ve --applicationId bağımsız değişkenleri gerektirir

Bu parametre için değer gerekmez. Bu bir anahtar.

--managedIdentity -mi

Varsayılan Azure kimliğini kullanın.

Bu parametre için değer gerekmez. Bu bir anahtar.

--name -n

Bu kimlik doğrulama profiline vermek istediğiniz ad (en fazla 30 karakter).

Not: Adın uzunluğu 1 ile 30 arasında olmalıdır

--password -p

İsteğe bağlı: Kimlik doğrulaması için parola

--tenant -t

Uygulama kimliği/istemci gizli dizisi veya uygulama kimliği/istemci sertifikası kullanılıyorsa kiracı kimliği.

--url -u

Kullanım dışı: Bunun yerine kullanın --environment .

--username -un

İsteğe bağlı: Kimlik doğrulaması için kullanılan kullanıcı adı; belirtilmezse bir Microsoft Entra Id iletişim kutusu gösterir.

Açıklamalar

parametresi için cloud , kullanılacak değerler şu diğer yaygın kısaltmalara veya adlara eşler:

  • GCC = UsGov
  • GCC Yüksek = UsGovHigh
  • DoD = UsGovDod

WSL2 Kimlik Doğrulama Sorunları

Linux sürüm 2 (WSL2) için Windows Alt Sistemi'ni kullanırken, WSL2 ortamınızda varsayılan tarayıcı ayarlı olmaması gibi Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools kimlik doğrulama sorunlarınız olabilir.

Bu sorunu geçici olarak çözmek için komutuna bayrağını ekleyerek cihaz kodu kimlik doğrulamasını --deviceCode kullanabilirsiniz auth create : pac auth create --environment {env-id} --deviceCode. Kimlik doğrulama işlemini tamamlamak için WSL2 dışındaki bir tarayıcıya kod girmeniz gerekir.

pac auth delete

Belirli bir kimlik doğrulama profilini silme

Example

pac auth delete --index 2

için İsteğe Bağlı Parametreler auth delete

--index -i

Silinecek profilin dizini

Not: Değer, en az 1 değerine sahip bir tamsayı olmalıdır.

--name -n

Etkin olacak profilin adı

Not: Adın uzunluğu 1 ile 30 arasında olmalıdır

pac auth list

Bu bilgisayarda depolanan kimlik doğrulama profillerini listele

pac auth name

Mevcut kimlik doğrulama profilini adlandırma veya yeniden adlandırma

Example

Aşağıdaki örnekte bir kimlik doğrulama profilinin nasıl yeniden adlandırılası gösterilmektedir. Bu durumda, dizin 1'e sahip profil 'Contoso Dev' olarak yeniden adlandırılır.

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

Için Gerekli Parametreler auth name

--index -i

Adlandırılacak/yeniden adlandırılacak profilin dizini

Not: Değer, en az 1 değerine sahip bir tamsayı olmalıdır.

--name -n

Bu kimlik doğrulama profiline vermek istediğiniz ad (en fazla 30 karakter).

Not: Adın uzunluğu 1 ile 30 arasında olmalıdır

pac auth select

Hangi kimlik doğrulama profilinin etkin olacağını seçin

Example

pac auth select --index 2

için İsteğe Bağlı Parametreler auth select

--index -i

Etkin olacak profilin dizini.

Not: Değer, en az 1 değerine sahip bir tamsayı olmalıdır.

--name -n

Etkin olacak profilin adı

Not: Adın uzunluğu 1 ile 30 arasında olmalıdır

pac auth update

Mevcut kimlik doğrulama profilinin adını veya hedef ortamını güncelleştirme

Örnekler

Aşağıdaki örneklerde komutun kullanımı gösterilmektedir pac auth update .

Kimlik doğrulama profilini ortam URL'si ile güncelleştirme

Bu örnekte, dizin 1 ile kimlik doğrulama profilinin adı Contoso Dev ve ortam URL'si https://contosodev.crm.dynamics.comile nasıl güncelleştirilecekleri gösterilmektedir.

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

Kimlik doğrulama profilini ortam kimliğiyle güncelleştirme

Bu örnekte, kimlik doğrulama profilinin ortam kimliğiyle 00000000-0000-0000-0000-000000000000dizin 1 ile nasıl güncelleştirilecekleri gösterilmektedir.

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

Için Gerekli Parametreler auth update

--index -i

Adlandırılacak/yeniden adlandırılacak profilin dizini

Not: Değer, en az 1 değerine sahip bir tamsayı olmalıdır.

için İsteğe Bağlı Parametreler auth update

--environment -env

Varsayılan ortam (kimlik, url, benzersiz ad veya kısmi ad).

--name -n

Bu kimlik doğrulama profiline vermek istediğiniz ad (en fazla 30 karakter).

pac auth who

Seçili durumdaki kimlik doğrulama profili hakkındaki bilgileri görüntüleme

Ayrıca bakınız

Microsoft Power Platform CLI Komut Grupları
Microsoft Power Platform CLI'ya genel bakış