Remove-EntraAgentIdentityBlueprint
Elimina um Blueprint de Identidade de Agente e todas as suas Identidades de Agente e Utilizadores de Agentes associados.
Sintaxe
Default (Predefinição)
Remove-EntraAgentIdentityBlueprint
-BlueprintId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
O Remove-EntraAgentIdentityBlueprint cmdlet realiza uma eliminação em cascata de um Blueprint de Identidade de Agente do Microsoft Entra. Isso:
- Encontra todas as Identidades de Agentes associadas à planta
- Para cada Identidade de Agente, encontra e elimina todos os Utilizadores de Agentes associados
- Elimina cada Identidade de Agente
- Apaga o próprio Blueprint de Identidade do Agente
O cmdlet requer confirmação antes de ser eliminado, a menos que o -Force switch seja utilizado. Use -WhatIf para pré-visualizar quais os recursos que seriam eliminados sem efetuar a eliminação.
Exemplos
Exemplo 1: Apagar um Blueprint e todos os recursos associados
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
Este exemplo elimina o blueprint, todas as suas Identidades de Agente e todos os Utilizadores de Agentes associados sem necessidade de confirmação.
Exemplo 2: Pré-visualização de eliminação com WhatIf
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -WhatIf
Este exemplo mostra quais os recursos que seriam eliminados sem qualquer eliminação.
Exemplo 3: Apagar com confirmação e inspecionar os resultados
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
$result = Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
Write-Host "Deleted Blueprint: $($result.BlueprintName)"
Write-Host "Deleted $($result.DeletedIdentities.Count) Agent Identity(ies)"
Write-Host "Deleted $($result.DeletedUsers.Count) Agent User(s)"
Este exemplo elimina o blueprint com confirmação interativa e inspeciona os resultados.
Parâmetros
-BlueprintId
O ID do Blueprint de Identidade do Agente para apagar. O cmdlet irá apagar em cascata todas as Identidades de Agentes e Utilizadores de Agentes associados a este blueprint.
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 |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predefinido: | True |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
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 |
-Force
Suprime o prompt de confirmação antes de apagar.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predefinido: | False |
| 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 |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
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.Collections.Hashtable
Devolve uma tabela de hash com propriedades: BlueprintId, BlueprintName, DeletedIdentities (array de informações de Identidade do Agente apagadas), DeletedUsers (array de informações de Utilizador do Agente apagadas) e Status.
Notas
Este cmdlet requer as seguintes permissões do Microsoft Graph:
- AgentIdentityBlueprint.ReadWrite.All
- AgentIdentity.DeleteRestore.All
- AgentIdUser.ReadWrite.All
O cmdlet requer uma ligação Microsoft Entra ativa. Use Connect-Entra com os telescópios acima para ligar primeiro.
Ordem de eliminação: Os Utilizadores Agentes são eliminados primeiro, depois as Identidades dos Agentes e, finalmente, o próprio blueprint. Se a eliminação de um Utilizador ou Identidade de Agente falhar, é exibido um aviso e o cmdlet continua com os recursos restantes.
Quando o blueprint tem muitas Identidades de Agente, o cmdlet suporta paginação para garantir que todas são encontradas.