Update-AzPolicyExemption
Esta operação atualiza uma isenção de política com o escopo e o nome fornecidos.
Syntax
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
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-AzPolicyExempt. 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 $NextMonthO primeiro comando obtém a data e hora 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-AzPolicyExempt. 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 -ClearExpirationO primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExempt. 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 MitigatedO primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExempt. 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 à 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-AzPolicyExempt. 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: [Backcompat] Limpar a hora da data de expiração
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpirationO primeiro comando obtém a isenção de política chamada PolicyExemption07 usando o cmdlet Get-AzPolicyExempt. 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Esta mensagem fará parte da resposta em caso de violação da política.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
O nome para exibição da atribuição de política.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExemptionCategory
A categoria de isenção da apólice
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputObject
| Tipo: | IPolicyExemption |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
O nome da isenção da apólice.
| Tipo: | String |
| Aliases: | PolicyExemptionName |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
String[]
Saídas
Notas
PSEUDÓNIMOS
Set-AzPolicyExemption
Azure PowerShell
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários