Update-AzPolicySetDefinition

Referentie

Module:: Az.Resources

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

Syntaxis

Update-AzPolicySetDefinition
      -Name <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-PolicyDefinition <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-PolicyDefinitionGroup <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicySetDefinition
      -Name <String>
      -ManagementGroupName <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-PolicyDefinition <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-PolicyDefinitionGroup <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicySetDefinition
      -Name <String>
      -SubscriptionId <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-PolicyDefinition <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-PolicyDefinitionGroup <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicySetDefinition
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-PolicyDefinition <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-PolicyDefinitionGroup <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicySetDefinition
      [-DisplayName <String>]
      [-Description <String>]
      [-PolicyDefinition <String>]
      [-Metadata <String>]
      [-Parameter <String>]
      [-PolicyDefinitionGroup <String>]
      [-BackwardCompatible]
      -InputObject <IPolicySetDefinition>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

Voorbeelden

Voorbeeld 1: De beschrijving van een beleidssetdefinitie bijwerken

$PolicySetDefinition = Get-AzPolicySetDefinition -ResourceId '/subscriptions/mySub/Microsoft.Authorization/policySetDefinitions/myPSSetDefinition'
Update-AzPolicySetDefinition -Id $PolicySetDefinition.ResourceId -Description 'Updated policy to not allow virtual machine creation'

De eerste opdracht haalt een beleidssetdefinitie op met behulp van de cmdlet Get-AzPolicySetDefinition. Met de opdracht wordt dat object opgeslagen in de $PolicySetDefinition variabele. Met de tweede opdracht wordt de beschrijving bijgewerkt van de definitie van de beleidsset die is geïdentificeerd door de eigenschap ResourceId van $PolicySetDefinition.

Voorbeeld 2: de metagegevens van een beleidssetdefinitie bijwerken

Update-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -Metadata '{"category":"Virtual Machine"}'

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

Voorbeeld 3: De groepen van een beleidssetdefinitie bijwerken

Update-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -GroupDefinition '[{ "name": "group1", "displayName": "Virtual Machine Security" }, { "name": "group2" }]'

Met deze opdracht worden de groepen van een beleidssetdefinitie met de naam VMPolicySetDefinition bijgewerkt.

Voorbeeld 4: De groepen van een beleidssetdefinitie bijwerken met behulp van een hash-tabel

$groupsJson = ConvertTo-Json @{ name = "group1"; displayName = "Virtual Machine Security" }, @{ name = "group2" }
Update-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -GroupDefinition $groupsJson

Met deze opdracht worden de groepen van een beleidssetdefinitie met de naam VMPolicySetDefinition bijgewerkt vanuit een hash-tabel.

Voorbeeld 5: [Backcompat] De metagegevens van een beleidssetdefinitie bijwerken

Set-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -Metadata '{"category":"Virtual Machine"}'

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

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 definitie van de beleidsset.

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

-DisplayName

De weergavenaam van de definitie van de beleidsset.

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:	IPolicySetDefinition
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 definitie van de beleidsset. 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

-Name

De naam van de definitie van de beleidsset die moet worden bijgewerkt.

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

-Parameter

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

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

-PolicyDefinition

De matrix met beleidsdefinities in JSON-tekenreeksvorm.

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

-PolicyDefinitionGroup

De metagegevens die groepen beleidsdefinitieverwijzingen beschrijven binnen de beleidssetdefinitie. Zie de sectie NOTES voor DE EIGENSCHAPPEN POLICYDEFINITIONGROUP en maak een hash-tabel.

Type:	String
Aliassen:	GroupDefinition
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
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

IPolicySetDefinition

String

Uitvoerwaarden