Get-EntraAgentIdentity

모듈:
Microsoft.Entra.Applications Module v1.3

ID로 에이전트 ID를 가져오거나 에이전트 ID 청사진에 대한 모든 에이전트 ID를 나열합니다.

구문

GetById (기본값) 

Get-EntraAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

GetByBlueprint 

Get-EntraAgentIdentity

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

Description

cmdlet은 Get-EntraAgentIdentity Microsoft Graph 에이전트 ID를 검색합니다. 함께 -AgentId사용하면 단일 에이전트 ID를 반환합니다. 함께 -AgentIdentityBlueprintId사용하면 지정된 청사진의 자식인 모든 에이전트 ID를 반환합니다. 청사진 ID가 제공되지 않으면 현재 세션의 저장된 청사진 ID를 사용하거나 청사진 ID를 묻는 메시지를 표시합니다.

예제

예제 1: ID로 에이전트 ID 가져오기

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

이 예제에서는 지정된 ID를 사용하여 에이전트 ID를 검색합니다.

예제 2: 청사진에 대한 모든 에이전트 ID 나열

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

이 예제에서는 지정된 에이전트 ID 청사진의 자식인 모든 에이전트 ID를 검색합니다.

예제 3: 현재 세션 청사진에 대한 에이전트 ID 나열

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)" }

다음은 저장된 청사진 ID를 사용하여 현재 세션에서 만든 청사진에 대한 모든 에이전트 ID를 나열하는 예제입니다.

예제 4: 오류 처리를 사용하여 에이전트 ID 가져오기

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: $_"
}

이 예제에서는 에이전트가 없는 경우를 catch하기 위해 오류 처리가 있는 에이전트 ID를 검색하는 방법을 보여 줍니다.

매개 변수

-AgentId

검색할 에이전트 ID의 ID입니다. GetById 매개 변수 집합과 함께 사용됩니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

GetById
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AgentIdentityBlueprintId

자식 에이전트 ID를 나열할 에이전트 ID 청사진의 ID입니다. 제공되지 않은 경우 현재 세션의 저장된 청사진 ID를 사용하거나 메시지를 표시합니다. GetByBlueprint 매개 변수 집합과 함께 사용됩니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

GetByBlueprint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

System.Object

사용하는 -AgentId경우 단일 에이전트 ID 개체를 반환합니다. 사용하는 -AgentIdentityBlueprintId경우 에이전트 ID 개체의 배열을 반환합니다. 각 개체에는 id, displayName, appId 및 servicePrincipalType과 같은 속성이 포함됩니다.

참고

지정된 ID를 가진 에이전트 ID 또는 청사진을 찾을 수 없으면 cmdlet에서 오류가 발생합니다. 청사진별로 나열할 때 모든 결과를 검색하는 페이지 매김을 지원합니다.

이 cmdlet에는 다음 Microsoft Graph 권한이 필요합니다.

  • 애플리케이션.Read.All