Remove-AzPolicyAssignment

Referensi

Modul:: Az.Resources

Operasi ini menghapus penetapan kebijakan, mengingat namanya dan cakupan tempatnya dibuat. Cakupan penetapan kebijakan adalah bagian dari ID sebelumnya '/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Sintaks

Remove-AzPolicyAssignment
      -Name <String>
      [-Scope <String>]
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPolicyAssignment
      -Id <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPolicyAssignment
      -InputObject <IPolicyIdentity>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Contoh

Contoh 1: Menghapus penetapan kebijakan berdasarkan nama dan cakupan

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId -Force

Perintah pertama mendapatkan grup sumber daya bernama ResourceGroup11 dengan menggunakan cmdlet Get-AzResourceGroup. Perintah menyimpan objek tersebut dalam variabel $ResourceGroup. Perintah kedua menghapus penetapan kebijakan bernama PolicyAssignment07 yang ditetapkan pada tingkat grup sumber daya. Properti ResourceId dari $ResourceGroup mengidentifikasi grup sumber daya.

Contoh 2: Menghapus penetapan kebijakan berdasarkan ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false

Perintah pertama mendapatkan grup sumber daya bernama ResourceGroup11, lalu menyimpan objek tersebut dalam variabel $ResourceGroup. Perintah kedua mendapatkan penetapan kebijakan di tingkat grup sumber daya, lalu menyimpannya dalam variabel $PolicyAssignment. Properti ResourceId dari $ResourceGroup mengidentifikasi grup sumber daya. Perintah akhir menghapus penetapan kebijakan yang diidentifikasi properti ResourceId dari $PolicyAssignment.

Contoh 3: [Backcompat] Hapus penetapan kebijakan berdasarkan ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyAssignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyAssignment -Id $PolicyAssignment.ResourceId -Confirm:$false -BackwardCompatible
True

Parameter

-BackwardCompatible

Menyebabkan cmdlet mengembalikan artefak menggunakan format warisan yang menempatkan properti khusus kebijakan dalam objek tas properti.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Parameter DefaultProfile tidak berfungsi. Gunakan parameter SubscriptionId saat tersedia jika menjalankan cmdlet terhadap langganan yang berbeda.

Jenis:	PSObject
Alias:	AzureRMContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Force

Saat $true, lewati perintah konfirmasi

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Id

ID penetapan kebijakan yang akan dihapus. Gunakan format '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Jenis:	String
Alias:	ResourceId, PolicyAssignmentId
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-InputObject

Parameter Identitas Untuk membangun, lihat bagian CATATAN untuk properti INPUTOBJECT dan membuat tabel hash.

Jenis:	IPolicyIdentity
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-Name

Nama penetapan kebijakan yang akan dihapus.

Jenis:	String
Alias:	PolicyAssignmentName
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-PassThru

Mengembalikan true ketika perintah berhasil

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Scope

Cakupan penetapan kebijakan. Cakupan yang valid adalah: grup manajemen (format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), langganan (format: '/subscriptions/{subscriptionId}'), grup sumber daya (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', atau sumber daya (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

IPolicyIdentity

String

Output

Boolean

Bagikan melalui