Get-EntraBetaAgentIdentity

Moduł:
Microsoft.Entra.Beta.Applications Module v1.3

Pobiera tożsamość agenta według jego identyfikatora.

Składnia

Default (domyślnie) 

Get-EntraBetaAgentIdentity

    -AgentId <String>
    [<CommonParameters>]

Opis

Polecenie Get-EntraBetaAgentIdentity cmdlet pobiera tożsamość agenta z Microsoft Graph przy użyciu podanego identyfikatora agenta. Zwraca obiekt tożsamości agenta, jeśli został znaleziony, lub zgłasza błąd, jeśli nie zostanie znaleziony.

Przykłady

Przykład 1. Uzyskiwanie tożsamości agenta według identyfikatora

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

W tym przykładzie jest pobierana tożsamość agenta z określonym identyfikatorem.

Przykład 2. Uzyskiwanie tożsamości agenta z obsługą błędów

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

W tym przykładzie pokazano, jak pobrać tożsamość agenta z obsługą błędów w celu przechwycenia przypadków, w których agent nie istnieje.

Parametry

-AgentId

Identyfikator tożsamości agenta do pobrania.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.Object

Zwraca obiekt Tożsamości agenta z właściwościami, takimi jak id, displayName, appId i inne szczegóły tożsamości agenta.

Notatki

Jeśli tożsamość agenta o określonym identyfikatorze nie zostanie znaleziona, polecenie cmdlet zgłosi błąd.