Get-AzPolicyAssignment

Referensi

Modul:: Az.Resources

Mendapatkan penetapan kebijakan.

Sintaks

Get-AzPolicyAssignment
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Name <String>
   [-Scope <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   -PolicyDefinitionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Scope <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzPolicyAssignment mendapatkan semua penetapan kebijakan atau penugasan tertentu. Identifikasi penetapan kebijakan untuk mendapatkan berdasarkan nama dan cakupan atau menurut ID.

Contoh

Contoh 1: Mendapatkan semua penetapan kebijakan

Get-AzPolicyAssignment

Perintah ini mendapatkan semua penetapan kebijakan.

Contoh 2: Mendapatkan penetapan kebijakan tertentu

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

Perintah pertama mendapatkan grup sumber daya bernama ResourceGroup11 dengan menggunakan cmdlet Get-AzResourceGroup dan menyimpannya dalam variabel $ResourceGroup. Perintah kedua mendapatkan penetapan kebijakan bernama PolicyAssignment07 untuk cakupan yang diidentifikasi properti ResourceId dari $ResourceGroup.

Contoh 3: Mendapatkan semua penetapan kebijakan yang ditetapkan ke grup manajemen

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

Perintah pertama menentukan ID grup manajemen yang akan dikueri. Perintah kedua mendapatkan semua penetapan kebijakan yang ditetapkan ke grup manajemen dengan ID 'myManagementGroup'.

Contoh 4: Dapatkan cakupan, pengidentifikasi definisi kumpulan kebijakan, dan nama tampilan semua penetapan kebijakan yang diformat sebagai daftar

Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Perintah ini berguna saat Anda perlu menemukan properti DisplayName yang mudah dibaca pembaca dari penetapan Azure Policy.

Contoh 5: [Backcompat] Dapatkan cakupan, pengidentifikasi definisi kumpulan kebijakan, dan nama tampilan semua penetapan kebijakan yang diformat sebagai daftar

Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Perintah ini berguna saat Anda perlu menemukan properti DisplayName yang mudah dibaca pembaca dari penetapan Azure Policy.

Parameter

-BackwardCompatible

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	String
Aliases:	ResourceId, PolicyAssignmentId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

Dapatkan semua penetapan kebijakan yang menargetkan DEFINISI kebijakan yang diberikan [sepenuhnya memenuhi syarat] ID.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nama penetapan kebijakan yang akan didapatkan.

Type:	String
Aliases:	PolicyAssignmentName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

Dapatkan semua penetapan kebijakan yang menargetkan DEFINISI kebijakan yang diberikan [sepenuhnya memenuhi syarat] ID.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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}'

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Input

SwitchParameter

String

Output

IPolicyAssignment

Share via