Get-AzureRmPolicyAssignment
Hiermee worden beleidstoewijzingen opgehaald.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntax
Get-AzureRmPolicyAssignment
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Get-AzureRmPolicyAssignment
[-Name <String>]
[-Scope <String>]
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Get-AzureRmPolicyAssignment
[-Scope <String>]
[-IncludeDescendent]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Get-AzureRmPolicyAssignment
-Id <String>
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
Met de cmdlet Get-AzureRmPolicyAssignment 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
PS C:\> Get-AzureRmPolicyAssignment
Met deze opdracht worden alle beleidstoewijzingen opgehaald.
Voorbeeld 2: Een specifieke beleidstoewijzing ophalen
PS C:\> $ResourceGroup = Get-AzureRmResourceGroup -Name 'ResourceGroup11'
PS C:\> Get-AzureRmPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId
De eerste opdracht haalt een resourcegroep met de naam ResourceGroup11 op met behulp van de cmdlet Get-AzureRMResourceGroup 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
PS C:\> $mgId = 'myManagementGroup'
PS C:\> Get-AzureRmPolicyAssignment -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'.
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 |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Hiermee geeft u de volledig gekwalificeerde resource-id op voor de beleidstoewijzing die door deze cmdlet wordt opgehaald.
Type: | String |
Aliases: | ResourceId |
Position: | Named |
standaardwaarde: | None |
Vereist: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
standaardwaarde: | None |
Vereist: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis. De aanvaardbare waarden voor deze parameter zijn:
- Verdergaan
- Negeren
- Informeren
- SilentlyContinue
- Stoppen
- Onderbreken
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Hiermee geeft u een informatievariabele op.
Type: | String |
Aliases: | iv |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam op van de beleidstoewijzing die door deze cmdlet wordt opgehaald.
Type: | String |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionId
Hiermee geeft u de id op van de beleidsdefinitie van de beleidstoewijzingen die door deze cmdlet worden opgehaald.
Type: | String |
Position: | Named |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
standaardwaarde: | None |
Vereist: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |