Remove-EntraAgentIdentityBlueprint
Elimina un progetto di identità agente e tutte le identità dell'agente associate e gli utenti dell'agente.
Sintassi
Default (Impostazione predefinita)
Remove-EntraAgentIdentityBlueprint
-BlueprintId <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il Remove-EntraAgentIdentityBlueprint cmdlet esegue un'eliminazione a catena di un progetto di identità dell'agente da Microsoft Entra. IT:
- Trova tutte le identità dell'agente associate al progetto
- Per ogni identità agente, trova ed elimina tutti gli utenti dell'agente associati
- Elimina ogni identità agente
- Elimina il progetto di identità dell'agente stesso
Il cmdlet richiede conferma prima dell'eliminazione, a meno che non venga usata l'opzione -Force . Usare -WhatIf per visualizzare in anteprima le risorse che verrebbero eliminate senza eseguire effettivamente l'eliminazione.
Esempio
Esempio 1: Eliminare un progetto e tutte le risorse associate
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -Force
In questo esempio viene eliminato il progetto, tutte le identità dell'agente e tutti gli utenti dell'agente associati senza chiedere conferma.
Esempio 2: Eliminazione in anteprima con WhatIf
Connect-Entra -Scopes 'AgentIdentityBlueprint.ReadWrite.All', 'AgentIdentity.DeleteRestore.All', 'AgentIdUser.ReadWrite.All'
Remove-EntraAgentIdentityBlueprint -BlueprintId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" -WhatIf
In questo esempio vengono illustrate le risorse che verrebbero eliminate senza eseguire eliminazioni.
Esempio 3: Eliminare con conferma ed esaminare i risultati
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)"
Questo esempio elimina il progetto con conferma interattiva ed esamina i risultati.
Parametri
-BlueprintId
ID del progetto di identità dell'agente da eliminare. Il cmdlet eliminerà a catena tutte le identità dell'agente e gli utenti dell'agente associati a questo progetto.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | True |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Elimina la richiesta di conferma prima dell'eliminazione.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Output
System.Collections.Hashtable
Restituisce una tabella hash con proprietà: BlueprintId, BlueprintName, DeletedIdentities (matrice di informazioni sull'identità dell'agente eliminate), DeletedUsers (matrice di informazioni utente agente eliminate) e Status.
Note
Questo cmdlet richiede le autorizzazioni Microsoft Graph seguenti:
- AgentIdentityBlueprint.ReadWrite.All
- AgentIdentity.DeleteRestore.All
- AgentIdUser.ReadWrite.All
Il cmdlet richiede una connessione Microsoft Entra attiva. Usare Connect-Entra con gli ambiti precedenti per connettersi per primi.
Ordine di eliminazione: gli utenti dell'agente vengono eliminati prima, quindi identità agente e infine il progetto stesso. Se l'eliminazione di un singolo utente agente o identità agente ha esito negativo, viene visualizzato un avviso e il cmdlet continua con le risorse rimanenti.
Quando il progetto ha molte identità dell'agente, il cmdlet supporta l'impaginazione per assicurarsi che vengano trovati tutti.