Get-AzPolicyAssignment
Ottiene le assegnazioni di criteri.
Sintassi
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>] Descrizione
Il cmdlet Get-AzPolicyAssignment ottiene tutte le assegnazioni di criteri o specifiche assegnazioni. Identificare un'assegnazione di criteri per ottenere in base al nome e all'ambito o all'ID.
Esempio
Esempio 1: Ottenere tutte le assegnazioni di criteri
Get-AzPolicyAssignmentQuesto comando ottiene tutte le assegnazioni dei criteri.
Esempio 2: Ottenere un'assegnazione di criteri specifica
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceIdIl primo comando ottiene un gruppo di risorse denominato ResourceGroup11 usando il cmdlet Get-AzResourceGroup e lo archivia nella variabile $ResourceGroup. Il secondo comando ottiene l'assegnazione di criteri denominata PolicyAssignment07 per l'ambito identificato dalla proprietà ResourceId di $ResourceGroup.
Esempio 3: Ottenere tutte le assegnazioni di criteri assegnate a un gruppo di gestione
$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'Il primo comando specifica l'ID del gruppo di gestione su cui eseguire la query. Il secondo comando ottiene tutte le assegnazioni di criteri assegnate al gruppo di gestione con ID 'myManagementGroup'.
Esempio 4: Ottenere l'ambito, l'identificatore di definizione del set di criteri e il nome visualizzato di tutte le assegnazioni di criteri formattate come elenco
Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-ListQuesto comando è utile quando è necessario trovare la proprietà DisplayName descrittiva per il lettore di un'assegnazione di Criteri di Azure.
Esempio 5: [Backcompat] Ottenere l'ambito, l'identificatore di definizione del set di criteri e il nome visualizzato di tutte le assegnazioni di criteri formattate come elenco
Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-ListQuesto comando è utile quando è necessario trovare la proprietà DisplayName descrittiva per il lettore di un'assegnazione di Criteri di Azure.
Parametri
-BackwardCompatible
Fa sì che il cmdlet restituisca artefatti usando il formato legacy inserendo proprietà specifiche dei criteri in un oggetto contenitore delle proprietà.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.
| Tipo: | PSObject |
| Alias: | AzureRMContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Id
ID dell'assegnazione dei criteri da ottenere. Usare il formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.
| Tipo: | String |
| Alias: | ResourceId, PolicyAssignmentId |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-IncludeDescendent
Fa in modo che l'elenco delle assegnazioni di criteri restituite includa tutte le assegnazioni correlate all'ambito specificato, incluse quelle degli ambiti predecessori e quelle degli ambiti discendenti. Se non specificato, vengono incluse solo le assegnazioni in corrispondenza e sopra l'ambito specificato.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Nome dell'assegnazione dei criteri da ottenere.
| Tipo: | String |
| Alias: | PolicyAssignmentName |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-PolicyDefinitionId
Ottiene tutte le assegnazioni di criteri destinate all'ID di definizione di criteri [completo] specificato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Scope
Ambito dell'assegnazione dei criteri. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}'), gruppo di risorse (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o risorsa (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
