Update-AzPolicyDefinition

Başvuru

Modül:: Az.Resources

Bu işlem, verilen abonelik veya yönetim grubundaki mevcut ilke tanımını verilen adla güncelleştirir.

Sözdizimi

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

Bu işlem, verilen abonelik veya yönetim grubundaki mevcut ilke tanımını verilen adla güncelleştirir.

Örnekler

Örnek 1: İlke tanımının açıklamasını güncelleştirme

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

İlk komut Get-AzPolicyDefinition cmdlet'ini kullanarak VMPolicyDefinition adlı bir ilke tanımı alır. Komut bu nesneyi $PolicyDefinition değişkeninde depolar. İkinci komut, $PolicyDefinition ResourceId özelliği tarafından tanımlanan ilke tanımının açıklamasını güncelleştirir.

Örnek 2: İlke tanımının modunu güncelleştirme

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

Bu komut, mode özelliğini 'All' olarak ayarlamak için Update-AzPolicyDefinition cmdlet'ini kullanarak VMPolicyDefinition adlı ilke tanımını güncelleştirir.

Örnek 3: İlke tanımının meta verilerini güncelleştirme

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

Bu komut, vmPolicyDefinition adlı ilke tanımının meta verilerini güncelleştirerek kategorisinin "Sanal Makine" olduğunu gösterir.

Örnek 3: [Backcompat] İlke tanımının modunu güncelleştirme

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

Bu komut, mode özelliğini 'All' olarak ayarlamak için Update-AzPolicyDefinition cmdlet'in Set-AzPolicyDefinition diğer adını kullanarak VMPolicyDefinition adlı ilke tanımını güncelleştirir.

Parametreler

-BackwardCompatible

Cmdlet'in bir özellik paketi nesnesine ilkeye özgü özellikler yerleştirerek eski biçimi kullanarak yapıtlar döndürmesine neden olur.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

DefaultProfile parametresi işlevsel değil. Cmdlet'i farklı bir abonelikte yürütürken kullanılabilir olduğunda SubscriptionId parametresini kullanın.

Tür:	PSObject
Diğer adlar:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Description

İlke tanımı açıklaması.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-DisplayName

İlke tanımının görünen adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Id

Güncelleştirilecek ilke tanımının kaynak kimliği.

Tür:	String
Diğer adlar:	ResourceId
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-InputObject

Tür:	IPolicyDefinition
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ManagementGroupName

Yönetim grubunun kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Metadata

İlke tanımı meta verileri. Meta veriler açık uçlu bir nesnedir ve genellikle anahtar değer çiftleri koleksiyonudur.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Mode

İlke tanımı modu. Bazı örnekler All, Indexed, Microsoft.KeyVault.Data'dır.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Güncelleştirilecek ilke tanımının adı.

Tür:	String
Diğer adlar:	PolicyDefinitionName
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Parameter

İlke kuralında kullanılan parametreler için parametre tanımları. Anahtarlar parametre adlarıdır.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Policy

İlke kuralı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-SubscriptionId

Hedef aboneliğin kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

IPolicyDefinition

String

Çıkışlar