New-EntraAgentIdentityBlueprint

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

Cria um novo Blueprint de Identidade do Agente.

Sintaxe

Default (Default) 

New-EntraAgentIdentityBlueprint

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

Description

O New-EntraAgentIdentityBlueprint cmdlet cria um novo Blueprint de Identidade do Agente usando a API Microsoft Graph v1.0. Um Blueprint de Identidade do Agente serve como um modelo para criar identidades de agente com configurações e permissões consistentes.

Exemplos

Exemplo 1: criar um blueprint com patrocinadores e proprietários

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

Este exemplo cria um Blueprint de Identidade do Agente com o nome de exibição, os patrocinadores e os proprietários especificados.

Exemplo 2: criar um blueprint com patrocinadores de usuário e grupo

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

Este exemplo cria um Blueprint de Identidade do Agente com patrocinadores de usuário e grupo.

Exemplo 3: criar um blueprint com apenas patrocinadores de usuário

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

Este exemplo cria um Blueprint de Identidade do Agente com vários patrocinadores de usuário.

Parâmetros

-DisplayName

O nome de exibição do Blueprint de Identidade do Agente.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OwnerUserIds

Matriz de IDs de usuário ou UPNs a serem definidas como proprietários.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SponsorGroupIds

Matriz de IDs de grupo a serem definidas como patrocinadores.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SponsorUserIds

Matriz de IDs de usuário ou UPNs a serem definidas como patrocinadores.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.String

Retorna a ID do Blueprint de Identidade do Agente.

Observações

Pelo menos um patrocinador (usuário ou grupo) deve ser especificado. Os proprietários são opcionais. Se os patrocinadores ou proprietários não forem fornecidos como parâmetros, o cmdlet solicitará interativamente e sugerirá o usuário atual como padrão. O cmdlet valida todas as IDs de usuário e grupo no locatário antes de criar o blueprint. A ID do blueprint é armazenada em uma variável de nível de módulo para uso por outros cmdlets relacionados.

Esse cmdlet usa o ponto de extremidade da API Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).

Esse cmdlet requer as seguintes permissões de Microsoft Graph:

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All