Remove-EntraAgentIdentityBlueprint
Hiermee verwijdert u een agentidentiteitsblauwdruk en alle bijbehorende agentidentiteiten en agentgebruikers.
Syntax
Default (Standaard)
Remove-EntraAgentIdentityBlueprint
-BlueprintId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De Remove-EntraAgentIdentityBlueprint cmdlet voert een trapsgewijze verwijdering van een Agent Identity Blueprint uit Microsoft Entra. Het:
- Hiermee vindt u alle agentidentiteiten die aan de blauwdruk zijn gekoppeld
- Voor elke agentidentiteit zoekt en verwijdert u alle gekoppelde agentgebruikers
- Verwijdert elke agentidentiteit
- Hiermee verwijdert u de agentidentiteitsblauwdruk zelf
De cmdlet vereist bevestiging voordat u deze verwijdert, tenzij de -Force switch wordt gebruikt. Gebruik -WhatIf dit om een voorbeeld te bekijken van welke resources worden verwijderd zonder de verwijdering daadwerkelijk uit te voeren.
Voorbeelden
Voorbeeld 1: Een blauwdruk en alle bijbehorende resources verwijderen
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
In dit voorbeeld worden de blauwdruk, alle agentidentiteiten en alle bijbehorende agentgebruikers verwijderd zonder dat u om bevestiging wordt gevraagd.
Voorbeeld 2: Voorbeeld van verwijdering met WhatIf
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -WhatIf
In dit voorbeeld ziet u welke resources worden verwijderd zonder verwijderingen uit te voeren.
Voorbeeld 3: Verwijderen met bevestigings- en inspectieresultaten
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)"
In dit voorbeeld wordt de blauwdruk verwijderd met interactieve bevestiging en worden de resultaten gecontroleerd.
Parameters
-BlueprintId
De id van de agentidentiteitsblauwdruk die u wilt verwijderen. Met de cmdlet worden alle agentidentiteiten en agentgebruikers die aan deze blauwdruk zijn gekoppeld, trapsgewijs verwijderd.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | True |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Onderdrukt de bevestigingsprompt voordat u deze verwijdert.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
Uitvoerwaarden
System.Collections.Hashtable
Retourneert een hashtabel met eigenschappen: BlueprintId, BlueprintName, DeletedIdentities (matrix met verwijderde agentidentiteitsgegevens), DeletedUsers (matrix met verwijderde agentgebruikersgegevens) en Status.
Notities
Voor deze cmdlet zijn de volgende Microsoft Graph machtigingen vereist:
- AgentIdentityBlueprint.ReadWrite.All
- AgentIdentity.DeleteRestore.All
- AgentIdUser.ReadWrite.All
Voor de cmdlet is een actieve Microsoft Entra-verbinding vereist. Gebruik Connect-Entra deze met de bovenstaande bereiken om eerst verbinding te maken.
Verwijderingsvolgorde: Agentgebruikers worden eerst verwijderd, vervolgens Agentidentiteiten en ten slotte de blauwdruk zelf. Als het verwijderen van een afzonderlijke agentgebruiker of agentidentiteit mislukt, wordt er een waarschuwing weergegeven en wordt de cmdlet voortgezet met de resterende resources.
Wanneer de blauwdruk veel agentidentiteiten heeft, ondersteunt de cmdlet paginering om ervoor te zorgen dat alles wordt gevonden.