Update-AzPolicyDefinition

Reference

Modul:: Az.Resources

Tato operace aktualizuje existující definici zásad v daném předplatném nebo skupině pro správu s daným názvem.

Syntaxe

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

Tato operace aktualizuje existující definici zásad v daném předplatném nebo skupině pro správu s daným názvem.

Příklady

Příklad 1: Aktualizace popisu definice zásady

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

První příkaz získá definici zásady s názvem VMPolicyDefinition pomocí rutiny Get-AzPolicyDefinition. Příkaz uloží tento objekt do proměnné $PolicyDefinition. Druhý příkaz aktualizuje popis definice zásady identifikované ResourceId vlastnost $PolicyDefinition.

Příklad 2: Aktualizace režimu definice zásady

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

Tento příkaz aktualizuje definici zásady s názvem VMPolicyDefinition pomocí rutiny Update-AzPolicyDefinition a nastaví její vlastnost režimu na All.

Příklad 3: Aktualizace metadat definice zásady

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

Tento příkaz aktualizuje metadata definice zásady s názvem VMPolicyDefinition, aby indikovala, že její kategorie je "Virtuální počítač".

Příklad 3: [Backcompat] Aktualizace režimu definice zásady

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

Tento příkaz aktualizuje definici zásady s názvem VMPolicyDefinition pomocí aliasu Set-AzPolicyDefinition rutiny Update-AzPolicyDefinition a nastaví jeho vlastnost režimu na All.

Parametry

-BackwardCompatible

Způsobí, že rutina vrátí artefakty pomocí staršího formátu, který umísťuje vlastnosti specifické pro zásady do objektu kontejneru vlastností.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Description

Popis definice zásady.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DisplayName

Zobrazovaný název definice zásady.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Id

ID prostředku definice zásady, která se má aktualizovat.

Typ:	String
Aliasy:	ResourceId
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-InputObject

Typ:	IPolicyDefinition
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ManagementGroupName

ID skupiny pro správu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Metadata

Metadata definice zásad. Metadata jsou otevřený objekt, který je obvykle kolekcí párů klíč-hodnota.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Mode

Režim definice zásad. Mezi příklady patří Vše, Indexováno, Microsoft.KeyVault.Data.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Název definice zásady, která se má aktualizovat.

Typ:	String
Aliasy:	PolicyDefinitionName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Parameter

Definice parametrů pro parametry použité v pravidle zásad. Klíče jsou názvy parametrů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Policy

Pravidlo zásad.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SubscriptionId

ID cílového předplatného.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

IPolicyDefinition

String

Výstupy