Remove-EntraAgentIdentityBlueprint

Modul:
Microsoft.Entra.Applications Module v1.3

Tar bort en agentidentitetsritning och alla dess associerade agentidentiteter och agentanvändare.

Syntax

Default (Standard) 

Remove-EntraAgentIdentityBlueprint

    -BlueprintId <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Remove-EntraAgentIdentityBlueprint utför en sammanhängande borttagning av en agentidentitetsritning från Microsoft Entra. Det:

  1. Hittar alla agentidentiteter som är associerade med skissen
  2. För varje agentidentitet hittar och tar bort alla associerade agentanvändare
  3. Tar bort varje agentidentitet
  4. Tar bort själva agentidentitetsritningen

Cmdleten kräver bekräftelse innan du tar bort om inte växeln -Force används. Använd -WhatIf för att förhandsgranska vilka resurser som skulle tas bort utan att faktiskt utföra borttagningen.

Exempel

Exempel 1: Ta bort en skiss och alla associerade resurser

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force

Det här exemplet tar bort skissen, alla dess agentidentiteter och alla associerade agentanvändare utan att fråga efter bekräftelse.

Exempel 2: Förhandsgranska borttagning med WhatIf

Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -WhatIf

Det här exemplet visar vilka resurser som skulle tas bort utan att några borttagningar utförs.

Exempel 3: Ta bort med bekräftelse och inspektera resultat

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)"

Det här exemplet tar bort skissen med interaktiv bekräftelse och inspekterar resultatet.

Parametrar

-BlueprintId

ID:t för agentidentitetsritningen som ska tas bort. Cmdleten tar bort alla agentidentiteter och agentanvändare som är associerade med den här skissen.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:True
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Undertrycker bekräftelseprompten innan den tas bort.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

System.Collections.Hashtable

Returnerar en hashtable med egenskaper: BlueprintId, BlueprintName, DeletedIdentities (matris med borttagen agentidentitetsinformation), DeletedUsers (matris med borttagen agentanvändarinformation) och Status.

Kommentarer

Den här cmdleten kräver följande Microsoft Graph behörigheter:

  • AgentIdentityBlueprint.ReadWrite.All
  • AgentIdentity.DeleteRestore.All
  • AgentIdUser.ReadWrite.All

Cmdleten kräver en aktiv Microsoft Entra anslutning. Använd Connect-Entra med ovanstående omfång för att ansluta först.

Borttagningsordning: Agentanvändare tas först bort, sedan agentidentiteter och slutligen själva skissen. Om det inte går att ta bort en enskild agentanvändare eller agentidentitet visas en varning och cmdleten fortsätter med de återstående resurserna.

När skissen har många agentidentiteter stöder cmdleten sidnumrering för att säkerställa att alla hittas.