New-EntraAgentIdentityBlueprint

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

Cria um novo Blueprint de Identidade de Agente.

Sintaxe

Default (Predefinição) 

New-EntraAgentIdentityBlueprint

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

Descrição

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

Exemplos

Exemplo 1: Criar um plano 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 Projeto de Identidade de Agente com o nome de exibição especificado, patrocinadores e proprietários.

Exemplo 2: Crie um blueprint com patrocinadores de utilizadores e de 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 de Agente com patrocinadores de utilizadores e de grupo.

Exemplo 3: Crie um blueprint apenas com patrocinadores utilizadores

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 de Agente com múltiplos patrocinadores utilizadores.

Parâmetros

-DisplayName

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

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OwnerUserIds

Array de IDs de utilizador ou UPNs para definir como proprietários.

Propriedades dos parâmetros

Tipo:

System.String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SponsorGroupIds

Conjunto de IDs de grupo para definir como patrocinadores.

Propriedades dos parâmetros

Tipo:

System.String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SponsorUserIds

Array de IDs de utilizador ou UPNs para definir como patrocinadores.

Propriedades dos parâmetros

Tipo:

System.String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Devolve o ID do Blueprint de Identidade do Agente.

Notas

Pelo menos um patrocinador (utilizador ou grupo) deve ser especificado. Os proprietários são opcionais. Se patrocinadores ou proprietários não forem fornecidos como parâmetros, o cmdlet solicita interativamente e sugere o utilizador atual como padrão. O cmdlet valida todos os IDs de utilizador e de grupo contra o tenant antes de criar o blueprint. O ID do blueprint é armazenado numa variável ao nível do módulo para uso por outros cmdlets relacionados.

Este cmdlet utiliza o endpoint da API Microsoft Graph v1.0 (/v1.0/applications/graph.agentIdentityBlueprint).

Este cmdlet requer as seguintes permissões do Microsoft Graph:

  • AgentIdentityBlueprint.Create
  • AgentIdentityBlueprint.UpdateAuthProperties.All