New-AzPolicyDefinition
Hiermee maakt of werkt u een beleidsdefinitie bij.
Syntax
Name (Standaard)
New-AzPolicyDefinition
-Name <String>
-Policy <String>
[-DisplayName <String>]
[-Description <String>]
[-Metadata <String>]
[-Parameter <String>]
[-Mode <String>]
[-Version <String>]
[-ExternalEvaluationEnforcementSettingMissingTokenAction <String>]
[-ExternalEvaluationEnforcementSettingResultLifespan <String>]
[-ExternalEvaluationEnforcementSettingRoleDefinitionId <String[]>]
[-EndpointSettingKind <String>]
[-EndpointSettingDetail <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ManagementGroupName
New-AzPolicyDefinition
-Name <String>
-ManagementGroupName <String>
-Policy <String>
[-DisplayName <String>]
[-Description <String>]
[-Metadata <String>]
[-Parameter <String>]
[-Mode <String>]
[-Version <String>]
[-ExternalEvaluationEnforcementSettingMissingTokenAction <String>]
[-ExternalEvaluationEnforcementSettingResultLifespan <String>]
[-ExternalEvaluationEnforcementSettingRoleDefinitionId <String[]>]
[-EndpointSettingKind <String>]
[-EndpointSettingDetail <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SubscriptionId
New-AzPolicyDefinition
-Name <String>
-SubscriptionId <String>
-Policy <String>
[-DisplayName <String>]
[-Description <String>]
[-Metadata <String>]
[-Parameter <String>]
[-Mode <String>]
[-Version <String>]
[-ExternalEvaluationEnforcementSettingMissingTokenAction <String>]
[-ExternalEvaluationEnforcementSettingResultLifespan <String>]
[-ExternalEvaluationEnforcementSettingRoleDefinitionId <String[]>]
[-EndpointSettingKind <String>]
[-EndpointSettingDetail <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de cmdlet New-AzPolicyDefinition wordt een beleidsdefinitie gemaakt of bijgewerkt die een JSON-indeling voor een beleidsregel bevat.
Voorbeelden
Voorbeeld 1: Een beleidsdefinitie maken met behulp van een beleidsbestand
{
"if": {
"field": "location",
"notIn": ["eastus", "westus", "centralus"]
},
"then": {
"effect": "audit"
}
}
New-AzPolicyDefinition -Name 'LocationDefinition' -Policy C:\LocationPolicy.json
Met deze opdracht maakt u een beleidsdefinitie met de naam LocationDefinition die de beleidsregel bevat die is opgegeven in C:\LocationPolicy.jsop.
Voorbeeldinhoud voor het LocationPolicy.json-bestand wordt hierboven weergegeven.
Drie bestandsindelingen voor bestandsindelingen worden ondersteund: 1. Alleen beleidsregel (voorbeeld hierboven).
2. Object beleidseigenschappen.
Deze indeling wordt weergegeven in de portal bij het bewerken van een beleidsdefinitie en kan parameters bevatten.
3. Volledig beleidsobject.
Deze indeling wordt gegenereerd door de Azure Policy exportfunctie en kan parameters bevatten.
Opmerking: waarden die zijn opgegeven op de opdrachtregel (bijvoorbeeld parameters, metagegevens) overschrijven overeenkomende waarden die aanwezig zijn in het bestand.
Voorbeeld 2: Een geparameteriseerde beleidsdefinitie maken met behulp van inlineparameters
{
"if": {
"field": "location",
"notIn": "[parameters('listOfAllowedLocations')]"
},
"then": {
"effect": "audit"
}
}
New-AzPolicyDefinition -Name 'LocationDefinition' -Policy C:\LocationPolicy.json -Parameter '{ "listOfAllowedLocations": { "type": "array" } }'
Met deze opdracht maakt u een beleidsdefinitie met de naam LocationDefinition die de beleidsregel bevat die is opgegeven in C:\LocationPolicy.jsop.
De parameterdefinitie voor de beleidsregel wordt inline gegeven.
Voorbeeld 3: Een beleidsdefinitie inline maken in een beheergroep
New-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName Dept42 -DisplayName 'Virtual Machine policy definition' -Policy '{"if":{"field":"type","equals":"Microsoft.Compute/virtualMachines"},"then":{"effect":"deny"}}'
Met deze opdracht maakt u een beleidsdefinitie met de naam VMPolicyDefinition in beheergroep Dept42.
Met de opdracht geeft u het beleid op als een tekenreeks in een geldige JSON-indeling.
New-AzPolicyDefinition -Name 'VMPolicyDefinition' -Metadata '{"category":"Virtual Machine"}' -Policy '{"if":{"field":"type","equals":"Microsoft.Compute/virtualMachines"},"then":{"effect":"deny"}}' | Format-List
Met deze opdracht maakt u een beleidsdefinitie met de naam VMPolicyDefinition met metagegevens die aangeven dat de categorie 'Virtuele machine' is.
Met de opdracht geeft u het beleid op als een tekenreeks in een geldige JSON-indeling.
Voorbeeld 5: Een beleidsdefinitie inline maken met de modus
New-AzPolicyDefinition -Name 'TagsPolicyDefinition' -Policy '{"if":{"value":"[less(length(field(''tags'')), 3)]","equals":true},"then":{"effect":"deny"}}' -Mode Indexed
Met deze opdracht maakt u een beleidsdefinitie met de naam TagsPolicyDefinition met de modus 'Geïndexeerd' die aangeeft dat het beleid alleen moet worden geëvalueerd voor resourcetypen die tags en locatie ondersteunen.
Voorbeeld 6: Een beleidsdefinitie inline maken met versie
New-AzPolicyDefinition -Name 'VMPolicyDefinition' -Policy '{"if":{"field":"type","equals":"Microsoft.Compute/virtualMachines"},"then":{"effect":"deny"}}' -Version '2.0.0'
Met deze opdracht maakt u een beleidsdefinitie met de naam VMPolicyDefinition met incrementele versie 2.0.0.
Met de opdracht geeft u het beleid op als een tekenreeks in een geldige JSON-indeling.
Voorbeeld 7: Een beleidsdefinitie maken met instellingen voor het afdwingen van externe evaluatie
New-AzPolicyDefinition -Name 'InvokePolicy' -Policy '{"if":{"value":"[claims().isValid]","equals":false},"then":{"effect":"deny"}}' -EndpointSettingKind 'CoinFlip' -ExternalEvaluationEnforcementSettingRoleDefinitionId @( "/providers/Microsoft.Authorization/roleDefinitions/b24988ac-6180-42a0-ab88-20f7382dd24c" )
Met deze opdracht maakt u een beleidsdefinitie met de naam InvokePolicy met instellingen voor externe evaluatie afdwinging om het CoinFlip-eindpunt aan te roepen. Hiervoor is de opgegeven roldefinitie vereist.
Parameters
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Cf
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-DefaultProfile
De parameter DefaultProfile is niet functioneel.
Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.
Parametereigenschappen
Type: PSObject
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: AzureRMContext, AzureCredential
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Description
De beschrijving van de beleidsdefinitie.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-DisplayName
De weergavenaam van de beleidsdefinitie.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-EndpointSettingDetail
De details van het eindpunt.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-EndpointSettingKind
Het type eindpunt.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ExternalEvaluationEnforcementSettingMissingTokenAction
Wat u moet doen bij het evalueren van een afdwingingsbeleid waarvoor een externe evaluatie is vereist en het token ontbreekt.
Mogelijke waarden zijn Controle en Weigeren en taalexpressies worden ondersteund.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ExternalEvaluationEnforcementSettingResultLifespan
De levensduur van het eindpuntaanroepresultaat waarna deze niet meer geldig is.
De waarde moet de ISO 8601-duurindeling en taalexpressies volgen.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ExternalEvaluationEnforcementSettingRoleDefinitionId
Een matrix van de roldefinitie-id's die de MSI van de toewijzing nodig heeft om het eindpunt aan te roepen.
Parametereigenschappen
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ManagementGroupName
De id van de beheergroep.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
ManagementGroupName
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
De metagegevens van de beleidsdefinitie.
Metagegevens zijn een geopend object en zijn meestal een verzameling sleutel-waardeparen.
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Mode
De beleidsdefinitiemodus.
Enkele voorbeelden zijn Alle, Geïndexeerd, Microsoft.KeyVault.Data.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Name
De naam van de beleidsdefinitie die moet worden gemaakt.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: PolicyDefinitionName
Parametersets
(All)
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Parameter
De parameterdefinities voor parameters die worden gebruikt in de beleidsregel.
De sleutels zijn de parameternamen.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Policy
De beleidsregel.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-SubscriptionId
De ID van het doelabonnement.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
SubscriptionId
Position: Named
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Version
De beleidsdefinitieversie in #.#.#-indeling.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: PolicyDefinitionVersion
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd.
De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Wi
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
Uitvoerwaarden