Get-EntraAgentIdentityBlueprint

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

Pobiera strategię tożsamości agenta według jego identyfikatora.

Składnia

Default (domyślnie) 

Get-EntraAgentIdentityBlueprint

    [-BlueprintId <String>]
    [<CommonParameters>]

Opis

Polecenie Get-EntraAgentIdentityBlueprint cmdlet pobiera strategię tożsamości agenta z Microsoft Graph przy użyciu interfejsu API w wersji 1.0 i podanego identyfikatora strategii. Jeśli nie podano identyfikatora, używa przechowywanego identyfikatora strategii z bieżącej sesji lub monituje o podanie tego identyfikatora. Zwraca obiekt strategii w przypadku znalezienia lub zgłasza błąd, jeśli nie zostanie znaleziony.

Przykłady

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

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"

W tym przykładzie pobrano strategię tożsamości agenta z określonym identyfikatorem.

Przykład 2. Pobieranie strategii z bieżącej sesji

Connect-Entra -Scopes 'AgentIdentityBlueprint.Create'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("admin@contoso.com")
$blueprint = Get-EntraAgentIdentityBlueprint
Write-Host "Blueprint: $($blueprint.displayName)"

W tym przykładzie pobrano strategię tożsamości agenta, która została utworzona w bieżącej sesji przy użyciu przechowywanego identyfikatora strategii.

Przykład 3. Pobieranie strategii tożsamości agenta z obsługą błędów

Connect-Entra -Scopes 'Application.Read.All'
try {
    $blueprint = Get-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    Write-Host "Blueprint found: $($blueprint.displayName)"
} catch {
    Write-Host "Blueprint not found or error occurred: $_"
}

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

Parametry

-BlueprintId

Identyfikator strategii tożsamości agenta do pobrania. Jeśli nie zostanie podana, użyj identyfikatora przechowywanej strategii z bieżącej sesji lub monituje o podanie tego identyfikatora.

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:False
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 Strategii tożsamości agenta z właściwościami, takimi jak id, appId, displayName, createdDateTime i requiredResourceAccess.

Notatki

Jeśli nie można odnaleźć strategii tożsamości agenta z określonym identyfikatorem, polecenie cmdlet zgłosi błąd.

To polecenie cmdlet używa punktu końcowego interfejsu API Microsoft Graph w wersji 1.0 (/v1.0/applications/microsoft.graph.agentIdentityBlueprint).

To polecenie cmdlet wymaga następujących uprawnień Microsoft Graph:

  • Application.Read.All