Aracılığıyla paylaş

Update-AzPolicyExemption

  • Başvuru
Modül:
Az.Resources

Bu işlem bir ilke muafiyetini verilen kapsam ve adla güncelleştirir.

Sözdizimi

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Bu işlem bir ilke muafiyetini verilen kapsam ve adla güncelleştirir.

Örnekler

Örnek 1: Görünen adı güncelleştirme

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'

İlk komut Get-AzResourceGroup cmdlet'ini kullanarak ResourceGroup11 adlı bir kaynak grubu alır. Komut bu nesneyi $ResourceGroup değişkeninde depolar. İkinci komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. Son komut, $ResourceGroup ResourceId özelliği tarafından tanımlanan kaynak grubundaki ilke muafiyetindeki görünen adı güncelleştirir.

Örnek 2: Son kullanma tarihi saatini güncelleştirme

$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth

İlk komut Get-Date cmdlet'ini kullanarak geçerli tarih saatini alır ve geçerli tarih saatine 1 ay ekler Komut bu nesneyi $NextMonth değişkeninde depolar. İkinci komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. Son komut, varsayılan abonelikte ilke muafiyeti için son kullanma tarihini güncelleştirir.

Örnek 3: Son kullanma tarihi saatini temizleme

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

İlk komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. İkinci komut, varsayılan abonelikte ilke muafiyeti için süre sonu tarihini temizler. Güncelleştirilmiş muafiyetin süresi hiçbir zaman dolmaz.

Örnek 4: Süre sonu kategorisini güncelleştirme

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated

İlk komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. İkinci komut, varsayılan abonelikte ilke muafiyeti için süre sonu kategorisini güncelleştirir. Güncelleştirilmiş muafiyetin süresi hiçbir zaman dolmaz.

İlk komut Get-Date cmdlet'ini kullanarak geçerli tarih saatini alır ve geçerli tarih saatine 1 ay ekler Komut bu nesneyi $NextMonth değişkeninde depolar. İkinci komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. Son komut, varsayılan abonelikte ilke muafiyeti için son kullanma tarihini güncelleştirir.

Örnek 5: Kaynak seçiciyi güncelleştirme

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

İlk komut, muafiyetin yalnızca Doğu ABD veya Doğu ABD 2 dışındaki konumlardaki kaynaklara uygulanacağını belirtmek için kullanılacak bir kaynak seçici nesnesi oluşturur ve bunu $ResourceSelector değişkeninde depolar. Son komut, VirtualMachineExemption adlı ilke muafiyetini $ResourceSelector tarafından belirtilen kaynak seçiciyle güncelleştirir.

Örnek 6: [Backcompat] Son kullanma tarihi saatini temizleme

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

İlk komut, Get-AzPolicyExemption cmdlet'ini kullanarak PolicyExemption07 adlı ilke muafiyetini alır. komut, bu nesneyi $PolicyExemption değişkeninde depolar. İkinci komut, varsayılan abonelikte ilke muafiyeti için süre sonu tarihini temizler. Güncelleştirilmiş muafiyetin süresi hiçbir zaman dolmaz.

Parametreler

-AssignmentScopeValidation

Muafiyetin atama kapsamında mı yoksa kapsamında mı olduğunu doğrulama seçeneği.

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

-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

-ClearExpiration

İlke muafiyetinin sona erme tarihi ve saatinin temizlenip temizlenmeyeceğini gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
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 ihlali durumunda bu ileti yanıtın bir parçası olacaktır.

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

-DisplayName

İlke ataması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

-ExemptionCategory

İlke muafiyeti kategorisi

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

-ExpiresOn

İlke muafiyetinin son kullanma tarihi ve saati (UTC ISO 8601 biçiminde yyyy-MM-ddTHH:mm:ssZ).

Tür:Nullable<T>[DateTime]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Id

Silinecek ilke atamasının kimliği. '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' biçimini kullanın.

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:IPolicyExemption
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Metadata

İlke atama 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

-Name

İlke muafiyetinin adı.

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

-PolicyDefinitionReferenceId

İlişkili ilke ataması bir ilke kümesine (girişim) yönelik olduğunda ilke tanımı başvuru kimliği listesi.

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

-ResourceSelector

İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici listesi.

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

-Scope

İlke muafiyetinin kapsamı. Geçerli kapsamlar şunlardır: yönetim grubu (biçim: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonelik (biçim: '/subscriptions/{subscriptionId}'), kaynak grubu (biçim: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', veya kaynak (biçim: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tür:String
Position:Named
Default value:None
Gerekli:False
İş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

IPolicyExemption

SwitchParameter

Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String

String[]

Çıkışlar

IPolicyExemption

Notlar

TAKMA

Set-AzPolicyExemption