New-EntraAgentIdentityBlueprint

Módulo:
Microsoft.Entra.Applications Module v1.3

Crea un nuevo plano técnico de identidad del agente.

Sintaxis

Default (valor predeterminado) 

New-EntraAgentIdentityBlueprint

    -DisplayName <String>
    [-SponsorUserIds <String[]>]
    [-SponsorGroupIds <String[]>]
    [-OwnerUserIds <String[]>]
    [<CommonParameters>]

Description

El New-EntraAgentIdentityBlueprint cmdlet crea un nuevo plano técnico de identidad del agente mediante la API de Microsoft Graph v1.0. Un plano técnico de identidad del agente actúa como plantilla para crear identidades de agente con una configuración y permisos coherentes.

Ejemplos

Ejemplo 1: Creación de un plano técnico con patrocinadores y propietarios

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

En este ejemplo se crea un plano técnico de identidad del agente con el nombre para mostrar, los patrocinadores y los propietarios especificados.

Ejemplo 2: Creación de un plano técnico con patrocinadores de usuarios y grupos

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

En este ejemplo se crea un plano técnico de identidad del agente con patrocinadores de usuarios y grupos.

Ejemplo 3: Creación de un plano técnico con solo patrocinadores de usuario

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

En este ejemplo se crea un plano técnico de identidad del agente con varios patrocinadores de usuario.

Parámetros

-DisplayName

Nombre para mostrar del plano técnico de identidad del agente.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OwnerUserIds

Matriz de identificadores de usuario o UPN que se van a establecer como propietarios.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SponsorGroupIds

Matriz de identificadores de grupo que se van a establecer como patrocinadores.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SponsorUserIds

Matriz de identificadores de usuario o UPN que se van a establecer como patrocinadores.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

System.String

Devuelve el identificador del plano técnico de identidad del agente.

Notas

Se debe especificar al menos un patrocinador (usuario o grupo). Los propietarios son opcionales. Si los patrocinadores o propietarios no se proporcionan como parámetros, el cmdlet solicita de forma interactiva y sugiere al usuario actual como valor predeterminado. El cmdlet valida todos los identificadores de usuario y grupo en el inquilino antes de crear el plano técnico. El identificador de plano técnico se almacena en una variable de nivel de módulo para su uso por otros cmdlets relacionados.

Este cmdlet usa el punto de conexión de api de Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).

Este cmdlet requiere los siguientes permisos Microsoft Graph:

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All