New-EntraAgentIdentityBlueprintPrincipal
Crea un'entità servizio per il progetto di identità dell'agente.
Sintassi
Default (Impostazione predefinita)
New-EntraAgentIdentityBlueprintPrincipal
[-AgentBlueprintId <String>]
[<CommonParameters>]
Descrizione
Il New-EntraAgentIdentityBlueprintPrincipal cmdlet crea un'entità servizio per il progetto di identità agente corrente usando l'endpoint graph.agentIdentityBlueprintPrincipal specializzato. Usa l'elemento AgentBlueprintId archiviato dall'ultima chiamata New-EntraAgentIdentityBlueprint. Se non è disponibile alcun ID archiviato e il parametro non viene specificato, il cmdlet richiede in modo interattivo l'ID applicazione del progetto.
Esempio
Esempio 1: Creare un'entità servizio usando l'ID progetto archiviato
Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com")
New-EntraAgentIdentityBlueprintPrincipal
Name Value
---- -----
id sp-aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb
appId bbbbbbbb-2222-3333-4444-cccccccccccc
displayName My Blueprint
servicePrincipalType Application
Questo esempio crea un'entità servizio per il progetto di identità dell'agente appena creato. Il cmdlet usa l'ID progetto archiviato dall'ultima creazione del progetto.
Esempio 2: Creare un'entità servizio con ID progetto specifico
Connect-Entra -Scopes 'AgentIdentityBlueprintPrincipal.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprintPrincipal -AgentBlueprintId "021fe0d0-d128-4769-950c-fcfbf7b87def"
Name Value
---- -----
id sp-aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb
appId 021fe0d0-d128-4769-950c-fcfbf7b87def
displayName My Blueprint
servicePrincipalType Application
Questo esempio crea un'entità servizio per un progetto di identità dell'agente specifico fornendo l'ID progetto.
Parametri
-AgentBlueprintId
ID applicazione (AppId) del progetto di identità dell'agente per cui creare l'entità servizio. Se non specificato, usa l'ID archiviato dall'ultima creazione del progetto.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Output
System.Object
Restituisce l'oggetto risposta dell'entità servizio da Microsoft Graph con proprietà che includono id, appId e displayName.
Note
Questo cmdlet richiede prima di tutto la creazione di un progetto di identità dell'agente. Se non viene specificato alcun parametro AgentBlueprintId e non è disponibile alcun ID archiviato da una chiamata precedente New-EntraAgentIdentityBlueprint , il cmdlet richiede in modo interattivo l'ID applicazione del progetto. Il cmdlet archivia l'ID entità servizio creato in una variabile a livello di modulo (CurrentAgentBlueprintServicePrincipalId) per l'uso da parte di altri cmdlet correlati, ad esempio il consenso e i cmdlet di configurazione delle autorizzazioni.
Il cmdlet include la logica di ripetizione dei tentativi (fino a 10 tentativi con attese di 10 secondi) per gestire i ritardi di propagazione dopo la creazione del progetto.
Questo cmdlet usa l'endpoint API Microsoft Graph v1.0 (/v1.0/servicePrincipals/graph.agentIdentityBlueprintPrincipal).
Questo cmdlet richiede le autorizzazioni Microsoft Graph seguenti:
- AgentIdentityBlueprintPrincipal.Create