Update-AzPolicyExemption
Essa 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>]
[-BackwardCompatible]
[-AssignmentScopeValidation <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzPolicyExemption
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
-Id <String>
[-DisplayName <String>]
[-Description <String>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-BackwardCompatible]
[-AssignmentScopeValidation <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzPolicyExemption
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-BackwardCompatible]
[-AssignmentScopeValidation <String>]
-InputObject <IPolicyExemption>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Essa operação atualiza uma isenção de política com o escopo e o nome fornecidos.
Exemplos
Exemplo 1: Atualizar o nome de 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-AzPolicyExemptation. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza o nome de exibição na isenção de política no grupo de recursos identificado pela propriedade ResourceId de $ResourceGroup.
Exemplo 2: Atualizar a data de expiração e hora
$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth
O primeiro comando obtém a data e hora atual usando o cmdlet Get-Date e adiciona 1 mês à data e hora 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-AzPolicyExemptation. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza a data de expiração e hora da isenção de política na assinatura padrão.
Exemplo 3: Limpar a data de expiração e hora
$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-AzPolicyExemptation. O comando armazena esse objeto na variável $PolicyExemption. O segundo comando limpa a 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-AzPolicyExemptation. 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 data e hora atual usando o cmdlet Get-Date e adiciona 1 mês à data e hora 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-AzPolicyExemptation. O comando armazena esse objeto na variável $PolicyExemption. O comando final atualiza a data de expiração e hora da isenção de política na assinatura padrão.
Exemplo 5: [Backcompat] Limpar a data de expiração e hora
$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-AzPolicyExemptation. O comando armazena esse objeto na variável $PolicyExemption. O segundo comando limpa a 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 se validar a isenção está no escopo de atribuição ou abaixo dele.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-BackwardCompatible
Faz com que o cmdlet retorne artefatos usando o formato herdado, colocando propriedades específicas da política em um objeto de recipiente de propriedades.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ClearExpiration
Indica se a data e a hora de expiração da isenção da apólice devem ser limpas.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Esta mensagem fará parte da resposta em caso de violação da política.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DisplayName
O nome de exibição da atribuição de política.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ExemptionCategory
A categoria de isenção de apólice
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ExpiresOn
A data e a hora de expiração (no formato UTC ISO 8601 aaaa-MM-ddTHH:mm:ssZ) da isenção de política.
Tipo: | Nullable<T>[DateTime] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-InputObject
Tipo: | IPolicyExemption |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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-chave.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
O nome da isenção da apólice.
Tipo: | String |
Aliases: | PolicyExemptionName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-PolicyDefinitionReferenceId
A lista de IDs de referência de definição de política quando a designação de política associada é para um conjunto de políticas (iniciativa).
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Scope
O escopo 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: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
String[]
Saídas
Observações
ALIASES
Set-AzPolicyExemption