Get-EntraBetaAgentIdentityToken

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

Verwerft een toegangstoken voor een agentidentiteit met behulp van clientreferenties.

Syntax

Default (Standaard) 

Get-EntraBetaAgentIdentityToken

    [-BlueprintAppId <String>]
    [-AgentIdentityAppId <String>]
    [-BlueprintSecret <SecureString>]
    [-Scope <String>]
    [-Mode <String>]
    [-UserToken <String>]
    [-UserUpn <String>]
    [<CommonParameters>]

Description

De Get-EntraBetaAgentIdentityToken cmdlet verkrijgt een toegangstoken voor een agentidentiteit met behulp van clientreferenties. Als u een nieuwe agentidentiteit voor deze sessie wilt maken, gebruikt u Invoke-EntraBetaAgentIdInteractive. Het token wordt geretourneerd als een tekenreeks.

Voorbeelden

Voorbeeld 1: Token ophalen met behulp van opgeslagen sessiewaarden

Connect-Entra -Scopes 'Application.ReadWrite.All'
# Create agent identity using interactive cmdlet
Invoke-EntraBetaAgentIdInteractive
# Get token using stored values from the session
$token = Get-EntraBetaAgentIdentityToken

In dit voorbeeld wordt een toegangstoken opgehaald met behulp van de blauwdruk- en agentidentiteit die in de huidige sessie is gemaakt.

Voorbeeld 2: Token ophalen met specifieke parameters

Connect-Entra -Scopes 'Application.ReadWrite.All'
$secret = ConvertTo-SecureString "your-secret-here" -AsPlainText -Force
$token = Get-EntraBetaAgentIdentityToken -BlueprintAppId "12345..." -AgentIdentityAppId "87654..." -BlueprintSecret $secret -Scope "https://graph.microsoft.com/.default"

In dit voorbeeld wordt een toegangstoken opgehaald door alle vereiste parameters expliciet op te geven.

Voorbeeld 3: Get token for OBO (On-Behalf-Of) flow

Connect-Entra -Scopes 'Application.ReadWrite.All'
$userToken = "user-access-token"
$token = Get-EntraBetaAgentIdentityToken -BlueprintAppId "12345..." -AgentIdentityAppId "87654..." -Scope "https://graph.microsoft.com/.default" -Mode OBO -UserToken $userToken

In dit voorbeeld wordt een toegangstoken opgehaald met behulp van de stroom On-Behalf-Of (OBO), waarbij de agent namens een gebruiker handelt.

Voorbeeld 4: Token ophalen voor autonome gebruikersmodus

Connect-Entra -Scopes 'Application.ReadWrite.All'
$token = Get-EntraBetaAgentIdentityToken -BlueprintAppId "12345..." -AgentIdentityAppId "87654..." -Scope "https://graph.microsoft.com/.default" -Mode AutonomousUser -UserUpn "user@contoso.com"

In dit voorbeeld wordt een toegangstoken opgehaald in de autonome gebruikersmodus, waarbij een UPN van een gebruiker wordt opgegeven.

Parameters

-AgentIdentityAppId

De id van de agent-id van de toepassing. Als deze niet is opgegeven, wordt de agentidentiteit gebruikt die in deze sessie is gemaakt.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-BlueprintAppId

De blauwdruktoepassings-id. Als deze niet is opgegeven, wordt de blauwdruk die in deze sessie is gemaakt, gebruikt.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-BlueprintSecret

Het cliëntgeheim van de blauwdruk. Als dit niet is opgegeven, wordt het geheim gebruikt dat in deze sessie is gemaakt.

Parametereigenschappen

Type:System.Security.SecureString
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Mode

Verificatiemodus: AutonomousApp (standaard), OBO of AutonomousUser.

Parametereigenschappen

Type:System.String
Default value:AutonomousApp
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Scope

Het bereik voor het verkrijgen van een token voor (bijvoorbeeld User.Read). Als dit niet is opgegeven, wordt het standaardbereik gebruikt (https://graph.microsoft.com/.default).

Parametereigenschappen

Type:System.String
Default value:https://graph.microsoft.com/.default
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UserToken

Gebruikerstoken voor de OBO-modus (vereist wanneer de modus OBO is).

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UserUpn

Upn van gebruiker voor de autonome gebruikersmodus (vereist wanneer de modus AutonomousUser is).

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Uitvoerwaarden

System.String

Retourneert het toegangstoken als een tekenreeks.

Notities

Deze cmdlet ondersteunt drie verificatiemodi:

  • AutonomousApp: Alleen-app-verificatie (standaard)
  • OBO: On-Behalf-Of flow waarbij de agent namens een gebruiker handelt
  • AutonomousUser: Gebruikersspecifieke verificatie