Get-EntraAgentIdentity

Modül:
Microsoft.Entra.Applications Module v1.3

Kimliğine göre Aracı Kimliği alır veya Bir Aracı Kimliği Şeması için tüm Aracı Kimliklerini listeler.

Syntax

GetById (Varsayılan) 

Get-EntraAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

GetByBlueprint 

Get-EntraAgentIdentity

    [-AgentIdentityBlueprintId <String>]
    [<CommonParameters>]

Description

cmdlet'i Get-EntraAgentIdentity Microsoft Graph bir Aracı Kimliği alır. ile -AgentIdkullanıldığında tek bir aracı kimliği döndürür. ile -AgentIdentityBlueprintIdkullanıldığında, belirtilen şemanın alt öğeleri olan tüm aracı kimliklerini döndürür. Şema kimliği sağlanmadıysa, geçerli oturumdaki depolanan şema kimliğini kullanır veya bir şema ister.

Örnekler

Örnek 1: Kimliğe göre Aracı Kimliği Alma

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraAgentIdentity -AgentId "27a3cf14-5bdc-4814-bb13-8f1740ca9a4f"

Bu örnek, belirtilen kimliğe sahip Aracı Kimliğini alır.

Örnek 2: Şema için tüm Aracı Kimliklerini listeleme

Connect-Entra -Scopes 'Application.Read.All'
$agents = Get-EntraAgentIdentity -AgentIdentityBlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
$agents | ForEach-Object { Write-Host "$($_.displayName) ($($_.id))" }

Bu örnek, belirtilen Aracı Kimliği Şemasının alt öğeleri olan tüm Aracı Kimliklerini alır.

Örnek 3: Geçerli oturum Şeması için Aracı Kimliklerini Listeleme

Connect-Entra -Scopes 'Application.Read.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
$agents = Get-EntraAgentIdentity -AgentIdentityBlueprintId
$agents | ForEach-Object { Write-Host "$($_.displayName)" }

Bu örnekte, depolanan şema kimliği kullanılarak geçerli oturumda oluşturulan şema için tüm Aracı Kimlikleri listelenir.

Örnek 4: Hata işleme ile Aracı Kimliği alma

Connect-Entra -Scopes 'Application.Read.All'
try {
    $agent = Get-EntraAgentIdentity -AgentId "27a3cf14-5bdc-4814-bb13-8f1740ca9a4f"
    Write-Host "Agent found: $($agent.displayName)"
} catch {
    Write-Host "Agent not found or error occurred: $_"
}

Bu örnekte, aracının mevcut olmadığı durumları yakalamak için hata işleme ile aracı kimliğinin nasıl alınacağı gösterilmektedir.

Parametreler

-AgentId

Alınacak Aracı Kimliğinin kimliği. GetById parametre kümesiyle kullanılır.

Parametre özellikleri

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

Parametre kümeleri

GetById
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

-AgentIdentityBlueprintId

Alt aracı kimliklerini listelemek için Aracı Kimliği Şemasının kimliği. Sağlanmadıysa, geçerli oturumdaki depolanan şema kimliğini kullanır veya bir tane ister. GetByBlueprint parametre kümesiyle birlikte kullanılır.

Parametre özellikleri

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

Parametre kümeleri

GetByBlueprint
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.

Girişler

None

Çıkışlar

System.Object

kullanırken -AgentIdtek bir Aracı Kimliği nesnesi döndürür. kullanırken -AgentIdentityBlueprintId, Aracı Kimliği nesnelerinin bir dizisini döndürür. Her nesne id, displayName, appId ve servicePrincipalType gibi özellikler içerir.

Notlar

Belirtilen kimliğe sahip Aracı Kimliği veya Şema bulunamazsa, cmdlet bir hata oluşturur. Şemaya göre listelendiğinde, tüm sonuçları almak için sayfalandırmayı destekler.

Bu cmdlet aşağıdaki Microsoft Graph izinlerini gerektirir:

  • Uygulama.Oku.Tümünü