Remove-EntraAgentIdentityBlueprint

Modul:
Microsoft.Entra.Applications Module v1.3

Menghapus Cetak Biru Identitas Agen dan semua Identitas Agen dan Pengguna Agen terkait.

Sintaks

Default (Default) 

Remove-EntraAgentIdentityBlueprint

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

Deskripsi

Remove-EntraAgentIdentityBlueprint Cmdlet melakukan penghapusan berskala Cetak Biru Identitas Agen dari Microsoft Entra. Hal itu:

  1. Menemukan semua Identitas Agen yang terkait dengan cetak biru
  2. Untuk setiap Identitas Agen, menemukan dan menghapus semua Pengguna Agen terkait
  3. Menghapus setiap Identitas Agen
  4. Menghapus Cetak Biru Identitas Agen itu sendiri

Cmdlet memerlukan konfirmasi sebelum menghapus kecuali sakelar -Force digunakan. Gunakan -WhatIf untuk mempratinjau sumber daya mana yang akan dihapus tanpa benar-benar melakukan penghapusan.

Contoh

Contoh 1: Menghapus Cetak Biru dan semua sumber daya terkait

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

Contoh ini menghapus cetak biru, semua Identitas Agennya, dan semua Pengguna Agen terkait tanpa meminta konfirmasi.

Contoh 2: Pratinjau penghapusan dengan WhatIf

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

Contoh ini menunjukkan sumber daya mana yang akan dihapus tanpa melakukan penghapusan apa pun.

Contoh 3: Hapus dengan konfirmasi dan periksa hasil

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

Contoh ini menghapus cetak biru dengan konfirmasi interaktif dan memeriksa hasilnya.

Parameter

-BlueprintId

ID Cetak Biru Identitas Agen yang akan dihapus. Cmdlet akan menghapus semua Identitas Agen dan Pengguna Agen yang terkait dengan cetak biru ini.

Properti parameter

Jenis:System.String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:System.Management.Automation.SwitchParameter
Nilai default:True
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Menekan prompt konfirmasi sebelum menghapus.

Properti parameter

Jenis:System.Management.Automation.SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:System.Management.Automation.SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Output

System.Collections.Hashtable

Mengembalikan hashtable dengan properti: BlueprintId, BlueprintName, DeletedIdentities (array info Identitas Agen yang dihapus), DeletedUsers (array info Pengguna Agen yang dihapus), dan Status.

Catatan

Cmdlet ini memerlukan izin Microsoft Graph berikut:

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

Cmdlet memerlukan koneksi Microsoft Entra aktif. Gunakan Connect-Entra dengan cakupan di atas untuk menyambungkan terlebih dahulu.

Urutan penghapusan: Pengguna Agen dihapus terlebih dahulu, lalu Identitas Agen, dan akhirnya cetak biru itu sendiri. Jika penghapusan Pengguna Agen atau Identitas Agen individu gagal, peringatan ditampilkan dan cmdlet berlanjut dengan sumber daya yang tersisa.

Ketika cetak biru memiliki banyak Identitas Agen, cmdlet mendukung penomoran halaman untuk memastikan semua ditemukan.