Connect-Entra

Modül:

Microsoft.Entra.Authentication Module v1.3

Kimliği doğrulanmış bir hesapla Microsoft Entra ID bağlanın.

Syntax

UserParameterSet (Varsayılan)

Connect-Entra
[[-Scopes]
    [[-Scopes] <String[]>]
    [[-ClientId] <String>]
    [-TenantId <String>]
    [-ContextScope <ContextScope>]
    [-Environment <String>]
    [-UseDeviceCode]
    [-ClientTimeout <Double>]
    [-NoWelcome]
    [<CommonParameters>]

AppCertificateParameterSet

Connect-Entra
[-ClientId]
    [-ClientId] <String>
    [[-CertificateSubjectName] <String>]
    [[-CertificateThumbprint] <String>]
    [-SendCertificateChain <Boolean>]
    [-Certificate <X509Certificate2>]
    [-TenantId <String>]
    [-ContextScope <ContextScope>]
    [-Environment <String>]
    [-ClientTimeout <Double>]
    [-NoWelcome]
    [<CommonParameters>]

IdentityParameterSet

Connect-Entra
[[-ClientId]
    [[-ClientId] <String>]
    [-ContextScope <ContextScope>]
    [-Environment <String>]
    [-ClientTimeout <Double>]
    [-Identity]
    [-NoWelcome]
    [<CommonParameters>]

AppSecretCredentialParameterSet

Connect-Entra
[-ClientSecretCredential
    [-ClientSecretCredential <PSCredential>]
    [-TenantId <String>]
    [-ContextScope <ContextScope>]
    [-Environment <String>]
    [-ClientTimeout <Double>]
    [-NoWelcome]
    [<CommonParameters>]

AccessTokenParameterSet

Connect-Entra
[-AccessToken]
    [-AccessToken] <SecureString>
    [-Environment <String>]
    [-ClientTimeout <Double>]
    [-NoWelcome]
    [<CommonParameters>]

EnvironmentVariableParameterSet

Connect-Entra
[-ContextScope
    [-ContextScope <ContextScope>]
    [-Environment <String>]
    [-ClientTimeout <Double>]
    [-EnvironmentVariable]
    [-NoWelcome]
    [<CommonParameters>]

Description

Connect-Entra Cmdlet, kimliği doğrulanmış bir hesapla Microsoft Entra ID bağlanır.

Kullanım örneğinize göre temsilci (etkileşimli) ve yalnızca uygulama (etkileşimli olmayan) gibi çeşitli kimlik doğrulama senaryoları desteklenir.

Connect-Entra , için Connect-MgGraphbir diğer addır.

Örnekler

Örnek 1: Temsilci erişimi: PowerShell oturumlarını kiracıya bağlama

Connect-Entra

Bu örnekte, kimlik bilgilerini kullanarak geçerli PowerShell oturumunuzu Microsoft Entra ID bir kiracıya nasıl bağlayacağınız gösterilmektedir.

Örnek 2: Temsilci erişimi: PowerShell oturumlarını gerekli kapsamlara sahip bir kiracıya bağlama

Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All'

Welcome to Microsoft Graph!

Bu örnek, kapsamlarla Microsoft Entra ID kimlik doğrulaması yapmayı gösterir.

Örnek 3: Temsilci erişimi: Erişim belirteci kullanma

$secureString = ConvertTo-SecureString -String $AccessToken -AsPlainText -Force
Connect-Entra -AccessToken $secureString

Welcome to Microsoft Graph!

Bu örnekte, erişim belirteci kullanarak Microsoft Entra ID etkileşimli kimlik doğrulamasının nasıl yapılacağını gösterilmektedir.

Erişim belirtecini alma veya oluşturma hakkında daha fazla bilgi için bkz. Erişim belirteci isteme.

Örnek 4: Temsilci erişimi: Cihaz kodu akışını kullanma

Connect-Entra -UseDeviceCode

To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code A1B2CDEFGH to authenticate.

Bu örnekte, cihaz kodu akışını kullanarak Microsoft Entra ID için etkileşimli kimlik doğrulamasının nasıl yapılacağını gösterilmektedir.

Daha fazla bilgi için bkz . Cihaz Kodu akışı.

Örnek 5: Yalnızca uygulama erişimi: Sertifika parmak iziyle istemci kimlik bilgilerini kullanma

$connectParams = @{
    TenantId = 'aaaabbbb-0000-cccc-1111-dddd2222eeee'
    ApplicationId = '00001111-aaaa-2222-bbbb-3333cccc4444'
    CertificateThumbprint = 'AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00'
}

Connect-Entra @connectParams

Welcome to Microsoft Graph!

Bu örnekte ApplicationId ve CertificateThumbprint kullanarak kimlik doğrulamasının nasıl yapılacağını gösterilmektedir.

CertificateThumbprint'i alma veya oluşturma hakkında daha fazla bilgi için bkz. Yalnızca uygulama erişimiyle kimlik doğrulaması yapma.

Örnek 6: Yalnızca uygulama erişimi: Sertifika adıyla istemci kimlik bilgilerini kullanma

$params = @{
    ClientId = '00001111-aaaa-2222-bbbb-3333cccc4444'
    TenantId = 'aaaabbbb-0000-cccc-1111-dddd2222eeee'
    CertificateName = 'YOUR_CERT_SUBJECT'
}

Connect-Entra @params

 $Cert = Get-ChildItem Cert:\LocalMachine\My\$CertThumbprint
 Connect-Entra -ClientId '<App-Id>' -TenantId '<Tenant-Id>' -Certificate $Cert

Yukarıdaki komutu çalıştırarak sertifika konusunu bulabilirsiniz.

Örnek 7: Yalnızca uygulama erişimi: İstemci kimlik bilgilerini sertifikayla kullanma

$Cert = Get-ChildItem Cert:\LocalMachine\My\$CertThumbprint
$params = @{
    ClientId = '00001111-aaaa-2222-bbbb-3333cccc4444'
    TenantId = 'aaaabbbb-0000-cccc-1111-dddd2222eeee'
    Certificate = $Cert
}

Connect-Entra @params

Örnek 8: Yalnızca uygulama erişimi: İstemci gizli anahtarı kimlik bilgilerini kullanma

$ClientSecretCredential = Get-Credential -Credential '00001111-aaaa-2222-bbbb-3333cccc4444'
# Enter client_secret in the password prompt.
Connect-Entra -TenantId 'aaaabbbb-0000-cccc-1111-dddd2222eeee' -ClientSecretCredential $ClientSecretCredential

Bu kimlik doğrulama yöntemi arka plan etkileşimleri için idealdir.

Kimlik bilgilerini alma hakkında daha fazla bilgi için bkz. Get-Credential komutu.

Örnek 9: Yalnızca uygulama erişimi: Yönetilen kimliği kullanma: Sistem tarafından atanan yönetilen kimlik

Connect-Entra -Identity

Bir hizmet örneğinde otomatik olarak yönetilen bir kimlik kullanır. Kimlik, bir hizmet örneğinin yaşam döngüsüne bağlıdır.

Örnek 10: Yalnızca uygulama erişimi: Yönetilen kimliği kullanma: Kullanıcı tarafından atanan yönetilen kimlik

Connect-Entra -Identity -ClientId 'User_Assigned_Managed_identity_Client_Id'

Kullanıcı tarafından oluşturulan yönetilen kimliği tek başına Azure kaynağı olarak kullanır.

Örnek 11: Bir ortama farklı bir kimlik olarak bağlanma

Connect-Entra -ContextScope 'Process'

Welcome to Microsoft Graph!

CurrentUser dışında farklı bir kimlik olarak bağlanmak için Process değeriyle ContextScope parametresini belirtin.

Geçerli bağlamı alma hakkında daha fazla bilgi için bkz. Get-EntraContext komutu.

Örnek 12: Bir ortama veya buluta bağlanma

Get-EntraEnvironment

Name     AzureADEndpoint                   GraphEndpoint                           Type
----     ---------------                   -------------                           ----
China    https://login.chinacloudapi.cn    https://microsoftgraph.chinacloudapi.cn Built-in
Global   https://login.microsoftonline.com https://graph.microsoft.com             Built-in
USGov    https://login.microsoftonline.us  https://graph.microsoft.us              Built-in
USGovDoD https://login.microsoftonline.us  https://dod-graph.microsoft.us          Built-in

Connect-Entra -Environment 'Global'

Connect-Entra'yı kullandığınızda, diğer ortamları hedeflemeyi seçebilirsiniz. varsayılan olarak Connect-Entra genel bulutu hedefler.

Örnek 13: HTTP istemcisi zaman aşımını saniyeler içinde ayarlar

 Connect-Entra -ClientTimeout 60

Welcome to Microsoft Graph!

Bu örnek HTTP istemcisi zaman aşımını saniyeler içinde ayarlar.

Örnek 14: Hoş geldiniz iletisini gizler

Connect-Entra -NoWelcome

Bu örnek hoş geldiniz iletisini gizler.

Örnek 15: Ortam değişkenlerini kullanarak kimlik doğrulamasına izin verir

Connect-Entra -EnvironmentVariable

Bu örnek, ortam değişkenlerini kullanarak kimlik doğrulamasına olanak tanır.

Parametreler

-AccessToken

Microsoft Entra hizmeti için taşıyıcı belirteci belirtir. Erişim belirteçleri zaman aşımına uğradı ve yenileme işlemlerini sizin yapmanız gerekiyor.

Parametre özellikleri

Tür:	SecureString
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AccessTokenParameterSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Certificate

Çağrı sırasında sağlanan bir X.509 sertifikası.

Parametre özellikleri

Tür:	X509Certificate2
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CertificateSubjectName

Sertifikanın konu ayırt edici adı. Sertifika, geçerli kullanıcının sertifika deposundan alınır.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	CertificateSubject, CertificateName

Parametre kümeleri

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CertificateThumbprint

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabının dijital ortak anahtar X.509 sertifikasının sertifika parmak izini belirtir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ClientId

Hizmet sorumlusunun uygulama kimliğini belirtir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	AppId, ApplicationId

Parametre kümeleri

UserParameterSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

IdentityParameterSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AppCertificateParameterSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ClientSecretCredential

PSCredential nesnesi, hizmet sorumlusu kimlik bilgileri için uygulama kimliğini ve istemci gizli dizisini sağlar. PSCredential nesnesi hakkında daha fazla bilgi için Get-Credential Get-Help yazın.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	SecretCredential, Referans

Parametre kümeleri

AppSecretCredentialParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ClientTimeout

HTTP istemcisi zaman aşımını saniyeler içinde ayarlar.

Parametre özellikleri

Tür:	System.Double
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ContextScope

Kimlik doğrulama bağlamının kapsamını belirler. Bu ContextScope geçerli işlemi veya CurrentUser kullanıcı tarafından başlatılan tüm oturumları kabul Process eder.

Parametre özellikleri

Tür:	ContextScope
Default value:	None
Kabul edilen değerler:	Process, CurrentUser
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

UserParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

IdentityParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AppSecretCredentialParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

EnvironmentVariableParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Environment

Bağlanacak ulusal bulut ortamının adı. Varsayılan olarak genel bulut kullanılır.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Ortam Adı, NationalCloud

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EnvironmentVariable

Konak makinede yapılandırılan ortam değişkenlerini kullanarak kimlik doğrulamasına izin verir. Bkz. https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/identity/Azure.Identity#environment-variables

Parametre özellikleri

Tür:	System.Management.Automation.SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

EnvironmentVariableParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Identity

Yönetilen kimlik kullanarak oturum açma

Parametre özellikleri

Tür:	System.Management.Automation.SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ManagedIdentity, ManagedServiceIdentity, MSI

Parametre kümeleri

IdentityParameterSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoWelcome

Hoş geldiniz iletisini gizler.

Parametre özellikleri

Tür:	System.Management.Automation.SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Scopes

Onay vermek için temsilci izinleri dizisi.

Parametre özellikleri

Tür:	System.String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

UserParameterSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SendCertificateChain

Verilen sertifikayı kullanarak konu adını /veren tabanlı kimlik doğrulamasını etkinleştirmek için bir belirteç alırken istemci taleplerine x5c üst bilgisi ekleyin.

Parametre özellikleri

Tür:	Boolean
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TenantId

Kiracının kimliğini belirtir.

Bu parametreyi belirtmezseniz, hesabın kimliği ev kiracısıyla doğrulanır.

Hizmet sorumlusu olarak veya Microsoft hesabı kullanırken kimlik doğrulaması yapmak için TenantId parametresini belirtmeniz gerekir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Hedef kitle, Kiracı

Parametre kümeleri

UserParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AppCertificateParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AppSecretCredentialParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UseDeviceCode

Tarayıcı denetimi yerine cihaz kodu kimlik doğrulaması kullanın.

Parametre özellikleri

Tür:	System.Management.Automation.SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	UseDeviceAuthentication, DeviceCode, DeviceAuth, Cihaz

Parametre kümeleri

UserParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

İlişkili Bağlantılar

• Disconnect-Entra