Get-AzPolicyAssignment
Hiermee worden beleidstoewijzingen opgehaald.
Syntaxis
Get-AzPolicyAssignment
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
[-Name <String>]
[-Scope <String>]
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
[-Scope <String>]
[-IncludeDescendent]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyAssignment
-Id <String>
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Met de cmdlet Get-AzPolicyAssignment worden alle beleidstoewijzingen of bepaalde toewijzingen opgehaald. Identificeer een beleidstoewijzing die moet worden opgehaald op naam en bereik of op id.
Voorbeelden
Voorbeeld 1: Alle beleidstoewijzingen ophalen
Get-AzPolicyAssignment
Met deze opdracht worden alle beleidstoewijzingen opgehaald.
Voorbeeld 2: Een specifieke beleidstoewijzing ophalen
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
De eerste opdracht haalt een resourcegroep met de naam ResourceGroup11 op met behulp van de Cmdlet Get-AzResourceGroup en slaat deze op in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidstoewijzing met de naam PolicyAssignment07 opgehaald voor het bereik dat de eigenschap ResourceId van $ResourceGroup identificeert.
Voorbeeld 3: alle beleidstoewijzingen ophalen die zijn toegewezen aan een beheergroep
$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'
Met de eerste opdracht geeft u de id van de beheergroep op die moet worden opvragen. Met de tweede opdracht worden alle beleidstoewijzingen opgehaald die zijn toegewezen aan de beheergroep met id 'myManagementGroup'.
Voorbeeld 4: Het bereik, de definitie-id van de beleidsset en de weergavenaam van alle beleidstoewijzingen ophalen die zijn opgemaakt als een lijst
Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
Deze opdracht is handig wanneer u de eigenschap DisplayName voor lezer van een Azure Policy-toewijzing moet vinden.
Parameters
-ApiVersion
Hiermee geeft u de versie van de resourceprovider-API die moet worden gebruikt. Als u geen versie opgeeft, gebruikt deze cmdlet de meest recente beschikbare versie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Type: | IAzureContextContainer |
Aliassen: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Id
Hiermee geeft u de volledig gekwalificeerde resource-id op voor de beleidstoewijzing die door deze cmdlet wordt opgehaald.
Type: | String |
Aliassen: | ResourceId |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-IncludeDescendent
Zorgt ervoor dat de lijst met geretourneerde beleidstoewijzingen alle toewijzingen bevat die betrekking hebben op het opgegeven bereik, inclusief toewijzingen van bovenliggende bereiken en toewijzingen van afstammende bereiken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam op van de beleidstoewijzing die door deze cmdlet wordt opgehaald.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PolicyDefinitionId
Hiermee geeft u de id op van de beleidsdefinitie van de beleidstoewijzingen die door deze cmdlet worden opgehaald.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Pre
Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Scope
Hiermee geeft u het bereik op waarop het beleid wordt toegepast voor de toewijzing die door deze cmdlet wordt opgehaald.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |