Partilhar via

Update-AzPolicyExemption

  • Referência
Módulo:
Az.Resources

Esta operação atualiza uma isenção de política com o escopo e o nome fornecidos.

Sintaxe

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

Esta operação atualiza uma isenção de política com o escopo e o nome fornecidos.

Exemplos

Exemplo 1: Atualizar o nome para exibição

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

O primeiro comando obtém um grupo de recursos chamado ResourceGroup11 usando o cmdlet Get-AzResourceGroup. O comando armazena esse objeto na variável $ResourceGroup. O segundo comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza o nome para exibição na isenção de política no grupo de recursos identificado pela propriedade ResourceId do $ResourceGroup.

Exemplo 2: Atualizar a hora da data de expiração

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

O primeiro comando obtém a hora da data atual usando o cmdlet Get-Date e adiciona 1 mês à hora da data atual O comando armazena esse objeto na variável $NextMonth. O segundo comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza a hora da data de expiração da isenção de política na assinatura padrão.

Exemplo 3: Limpar a hora da data de expiração

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

O primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O segundo comando limpa a hora da data de expiração para a isenção de política na assinatura padrão. A isenção atualizada nunca expirará.

Exemplo 4: Atualizar a categoria de expiração

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

O primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O segundo comando atualiza a categoria de expiração para a isenção de política na assinatura padrão. A isenção atualizada nunca expirará.

O primeiro comando obtém a hora da data atual usando o cmdlet Get-Date e adiciona 1 mês à hora da data atual O comando armazena esse objeto na variável $NextMonth. O segundo comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza a hora da data de expiração da isenção de política na assinatura padrão.

Exemplo 5: Atualizar seletor de recursos

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

O primeiro comando cria um objeto seletor de recursos que será usado para especificar que a isenção só deve ser aplicada a recursos em locais diferentes de East US ou East US 2 e armazena-o na variável $ResourceSelector. O comando final atualiza a isenção de política chamada VirtualMachineExemption com o seletor de recursos especificado por $ResourceSelector.

Exemplo 6: [Backcompat] Limpar a hora da data de expiração

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

O primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExemption. O comando armazena esse objeto na variável $PolicyExemption. O segundo comando limpa a hora da data de expiração para a isenção de política na assinatura padrão. A isenção atualizada nunca expirará.

Parâmetros

-AssignmentScopeValidation

A opção de validar a isenção está no âmbito da atribuição ou sob o mesmo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackwardCompatible

Faz com que o cmdlet retorne artefatos usando o formato herdado colocando propriedades específicas da política em um objeto de pacote de propriedades.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ClearExpiration

Indica se a data e a hora de expiração da isenção da apólice devem ser desmarcadas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Esta mensagem fará parte da resposta em caso de violação da política.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DisplayName

O nome para exibição da atribuição de política.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ExemptionCategory

A categoria de isenção da apólice

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ExpiresOn

A data e hora de expiração (no formato UTC ISO 8601 aaaa-MM-ddTHH:mm:ssZ) da isenção da apólice.

Tipo:Nullable<T>[DateTime]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Id

A ID da atribuição de política a ser excluída. Use o formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Tipo:String
Aliases:ResourceId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-InputObject

Tipo:IPolicyExemption
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Metadata

Os metadados de atribuição de política. Os metadados são um objeto aberto e normalmente são uma coleção de pares de valores de chave.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome da isenção da apólice.

Tipo:String
Aliases:PolicyExemptionName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicyDefinitionReferenceId

A lista ID de referência de definição de política quando a atribuição de política associada é para um conjunto de políticas (iniciativa).

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceSelector

A lista de seletores de recursos para filtrar políticas por propriedades de recursos.

Tipo:IResourceSelector[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

O âmbito da isenção da apólice. Os escopos válidos são: grupo de gerenciamento (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

IPolicyExemption

SwitchParameter

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

String

String[]

Saídas

IPolicyExemption

Notas

PSEUDÓNIMOS

Set-AzPolicyExemption