Get-AzPolicyDefinition
Hiermee haalt u beleidsdefinities op.
Syntaxis
Get-AzPolicyDefinition
[-Name <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-ManagementGroupName <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-SubscriptionId <Guid>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Builtin]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Custom]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
De cmdlet Get-AzPolicyDefinition haalt een verzameling beleidsdefinities of een specifieke beleidsdefinitie op die wordt geïdentificeerd met de naam of id.
Voorbeelden
Voorbeeld 1: Alle beleidsdefinities ophalen
Get-AzPolicyDefinition
Met deze opdracht worden alle beleidsdefinities ophaalt.
Voorbeeld 2: Beleidsdefinitie ophalen uit huidig abonnement op naam
Get-AzPolicyDefinition -Name 'VMPolicyDefinition'
Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit het huidige standaardabonnement.
Voorbeeld 3: Beleidsdefinitie ophalen uit beheergroep op naam
Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'
Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit de beheergroep met de naam Dept42.
Voorbeeld 4: Alle ingebouwde beleidsdefinities ophalen uit een abonnement
Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin
Met deze opdracht worden alle ingebouwde beleidsdefinities opgehaald uit het abonnement met id 3bf44b72-c631-427a-b8c8-53e2595398ca.
Voorbeeld 5: Beleidsdefinities ophalen uit een bepaalde categorie
Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}
Met deze opdracht worden alle beleidsdefinities in de categorieTags opgeslagen.
Voorbeeld 6: De weergavenaam, beschrijving, beleidstype en metagegevens ophalen van alle beleidsdefinities die zijn opgemaakt als een lijst
Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List
Deze opdracht is handig wanneer u de eigenschap DisplayName voor lezer van een Azure Policy-definitie moet vinden. U kunt de eigenschap Metagegevens parseren om het versienummer en de categorietoewijzing van de beleidsdefinitie te detecteren.
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 |
-Builtin
Hiermee beperkt u de lijst met resultaten tot alleen ingebouwde beleidsdefinities.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Custom
Hiermee beperkt u de lijst met resultaten tot alleen aangepaste beleidsdefinities.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
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 beleidsdefinitie die door deze cmdlet wordt ophaalt.
Type: | String |
Aliassen: | ResourceId |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ManagementGroupName
De naam van de beheergroep van de beleidsdefinitie(s) die u wilt ophalen.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam op van de beleidsdefinitie die door deze cmdlet wordt ophaalt.
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 |
-SubscriptionId
De abonnements-id van de beleidsdefinitie(s) die u wilt ophalen.
Type: | Nullable<T>[Guid] |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
Invoerwaarden
Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]