New-EntraAgentIdentityBlueprint
Crea un nuovo progetto di identità agente.
Sintassi
Default (Impostazione predefinita)
New-EntraAgentIdentityBlueprint
-DisplayName <String>
[-SponsorUserIds <String[]>]
[-SponsorGroupIds <String[]>]
[-OwnerUserIds <String[]>]
[<CommonParameters>]
Descrizione
Il New-EntraAgentIdentityBlueprint cmdlet crea un nuovo progetto di identità agente usando l'API Microsoft Graph v1.0. Un progetto di identità agente funge da modello per la creazione di identità agente con configurazione e autorizzazioni coerenti.
Esempio
Esempio 1: Creare un progetto con sponsor e proprietari
Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "My Blueprint" -SponsorUserIds @("user1@contoso.com") -OwnerUserIds @("owner1@contoso.com")
12345678-1234-1234-1234-123456789012
Questo esempio crea un progetto di identità agente con il nome visualizzato, gli sponsor e i proprietari specificati.
Esempio 2: Creare un progetto con sponsor di utenti e gruppi
Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "HR Blueprint" -SponsorUserIds @("hr-admin@contoso.com") -SponsorGroupIds @("aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb")
87654321-4321-4321-4321-210987654321
Questo esempio crea un progetto di identità agente con sponsor di utenti e gruppi.
Esempio 3: Creare un progetto con solo sponsor utente
Connect-Entra -Scopes 'AgentIdentityBlueprint.Create', 'AgentIdentityBlueprint.UpdateAuthProperties.All'
New-EntraAgentIdentityBlueprint -DisplayName "Finance Blueprint" -SponsorUserIds @("finance-admin@contoso.com", "finance-manager@contoso.com")
11112222-3333-4444-5555-666677778888
Questo esempio crea un progetto di identità agente con più sponsor utente.
Parametri
-DisplayName
Nome visualizzato per il progetto di identità dell'agente.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OwnerUserIds
Matrice di ID utente o UPN da impostare come proprietari.
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 |
-SponsorGroupIds
Matrice di ID gruppo da impostare come sponsor.
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 |
-SponsorUserIds
Matrice di ID utente o UPN da impostare come sponsor.
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.String
Restituisce l'ID del progetto di identità dell'agente.
Note
È necessario specificare almeno uno sponsor (utente o gruppo). I proprietari sono facoltativi. Se gli sponsor o i proprietari non vengono forniti come parametri, il cmdlet richiede in modo interattivo e suggerisce l'utente corrente come predefinito. Il cmdlet convalida tutti gli ID utente e gruppo nel tenant prima di creare il progetto. L'ID progetto viene archiviato in una variabile a livello di modulo per l'uso da parte di altri cmdlet correlati.
Questo cmdlet usa l'endpoint API Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).
Questo cmdlet richiede le autorizzazioni Microsoft Graph seguenti:
- AgentIdentityBlueprint.Create
- AgentIdentityBlueprint.UpdateAuthProperties.All