Update-AzPolicyDefinition

Referentie

Module:: Az.Resources

Met deze bewerking wordt een bestaande beleidsdefinitie in het opgegeven abonnement of beheergroep bijgewerkt met de opgegeven naam.

Syntaxis

Update-AzPolicyDefinition
      -Name <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-Policy <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-Mode <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyDefinition
      -Name <String>
      -SubscriptionId <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-Policy <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-Mode <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyDefinition
      -Name <String>
      -ManagementGroupName <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-Policy <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-Mode <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyDefinition
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-Policy <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-Mode <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyDefinition
      [-DisplayName <String>]
      [-Description <String>]
      [-Policy <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-Mode <String>]
      [-BackwardCompatible]
      -InputObject <IPolicyDefinition>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met deze bewerking wordt een bestaande beleidsdefinitie in het opgegeven abonnement of beheergroep bijgewerkt met de opgegeven naam.

Voorbeelden

Voorbeeld 1: De beschrijving van een beleidsdefinitie bijwerken

$PolicyDefinition = Get-AzPolicyDefinition -Name 'VMPolicyDefinition'
Update-AzPolicyDefinition -Id $PolicyDefinition.ResourceId -Description 'Updated policy to not allow virtual machine creation'

Met de eerste opdracht wordt een beleidsdefinitie met de naam VMPolicyDefinition ophaalt met behulp van de cmdlet Get-AzPolicyDefinition. Met de opdracht wordt dat object opgeslagen in de variabele $PolicyDefinition. Met de tweede opdracht wordt de beschrijving bijgewerkt van de beleidsdefinitie die is geïdentificeerd door de eigenschap ResourceId van $PolicyDefinition.

Voorbeeld 2: De modus van een beleidsdefinitie bijwerken

Update-AzPolicyDefinition -Name 'VMPolicyDefinition' -Mode 'All'

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition bijgewerkt met behulp van de cmdlet Update-AzPolicyDefinition om de moduseigenschap in te stellen op 'Alles'.

Voorbeeld 3: De metagegevens van een beleidsdefinitie bijwerken

Update-AzPolicyDefinition -Name 'VMPolicyDefinition' -Metadata '{"category":"Virtual Machine"}'

Met deze opdracht worden de metagegevens van een beleidsdefinitie met de naam VMPolicyDefinition bijgewerkt om aan te geven dat de categorie 'Virtuele machine' is.

Voorbeeld 3: [Backcompat] De modus van een beleidsdefinitie bijwerken

Set-AzPolicyDefinition -Name 'VMPolicyDefinition' -Mode 'All'

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition bijgewerkt met behulp van de Set-AzPolicyDefinition alias van de cmdlet Update-AzPolicyDefinition om de moduseigenschap in te stellen op 'All'.

Parameters

-BackwardCompatible

Zorgt ervoor dat cmdlet artefacten retourneert met behulp van verouderde indeling waarbij beleidsspecifieke eigenschappen in een eigenschapsverzamelingsobject worden geplaatst.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:	PSObject
Aliassen:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

De beschrijving van de beleidsdefinitie.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DisplayName

De weergavenaam van de beleidsdefinitie.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Id

De resource-id van de beleidsdefinitie die moet worden bijgewerkt.

Type:	String
Aliassen:	ResourceId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-InputObject

Type:	IPolicyDefinition
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ManagementGroupName

De id van de beheergroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Metadata

De metagegevens van de beleidsdefinitie. Metagegevens zijn een geopend object en zijn meestal een verzameling sleutel-waardeparen.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Mode

De beleidsdefinitiemodus. Enkele voorbeelden zijn Alle, Geïndexeerd, Microsoft.KeyVault.Data.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

De naam van de beleidsdefinitie die moet worden bijgewerkt.

Type:	String
Aliassen:	PolicyDefinitionName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Parameter

De parameterdefinities voor parameters die worden gebruikt in de beleidsregel. De sleutels zijn de parameternamen.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Policy

De beleidsregel.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SubscriptionId

De id van het doelabonnement.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

IPolicyDefinition

String

Uitvoerwaarden