Set-AzPolicyExemption
Hiermee wijzigt u een beleidsvrijstelling.
Syntaxis
Set-AzPolicyExemption
-Name <String>
[-Scope <String>]
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
-Id <String>
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
-InputObject <PsPolicyExemption>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Set-AzPolicyExemption wijzigt een beleidsuitzondering. Geef een uitzondering op id of op naam en bereik op.
Voorbeelden
Voorbeeld 1: De weergavenaam bijwerken
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'
Met de eerste opdracht wordt een resourcegroep met de naam ResourceGroup11 ophaalt met behulp van de cmdlet Get-AzResourceGroup. Met de opdracht wordt dat object opgeslagen in de variabele $ResourceGroup. Met de tweede opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de laatste opdracht wordt de weergavenaam bijgewerkt voor de beleidsuitzondering voor de resourcegroep die is geïdentificeerd door de eigenschap ResourceId van $ResourceGroup.
Voorbeeld 2: De vervaldatum bijwerken
$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth
Met de eerste opdracht wordt de huidige datum/tijd opgehaald met behulp van de cmdlet Get-Date en voegt u 1 maand toe aan de huidige datum/tijd. De opdracht slaat dat object op in de $NextMonth variabele. Met de tweede opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de laatste opdracht wordt de vervaldatum voor de beleidsvrijstelling voor het standaardabonnement bijgewerkt.
Voorbeeld 3: De vervaldatum wissen
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration
Met de eerste opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de tweede opdracht wordt de vervaldatum voor de beleidsvrijstelling voor het standaardabonnement gewist. De bijgewerkte uitzondering verloopt nooit.
Voorbeeld 4: De vervaldatumcategorie bijwerken
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated
Met de eerste opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de tweede opdracht wordt de vervaldatumcategorie voor de beleidsvrijstelling voor het standaardabonnement bijgewerkt. De bijgewerkte uitzondering verloopt nooit.
Parameters
-ApiVersion
Wanneer deze is ingesteld, geeft u de versie van de resourceprovider-API aan die moet worden gebruikt. Als deze niet is opgegeven, wordt de API-versie automatisch bepaald als de meest recente beschikbare versie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ClearExpiration
Als deze optie is ingesteld, wordt de vervaldatum en -tijd van de bijgewerkte beleidsvrijstelling gewist.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliassen: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Description
De beschrijving voor de bijgewerkte beleidsvrijstelling.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-DisplayName
De weergavenaam voor de bijgewerkte beleidsvrijstelling.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ExemptionCategory
De beleidsvrijstellingscategorie van de bijgewerkte beleidsvrijstelling. Mogelijke waarden zijn Afstandsverklaring en Beperkt.
Type: | String |
Geaccepteerde waarden: | Waiver, Mitigated |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ExpiresOn
De vervaldatum en -tijd (in UTC ISO 8601-indeling jjjj-MM-ddTHH:mm:ssZ) van de bijgewerkte beleidsvrijstelling.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Id
De volledig gekwalificeerde beleidsuitzonderings-id die moet worden bijgewerkt, inclusief het bereik, bijvoorbeeld /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
Type: | String |
Aliassen: | ResourceId |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-InputObject
Het object voor beleidsuitzondering om de uitvoer van een andere cmdlet bij te werken.
Type: | PsPolicyExemption |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Metadata
De metagegevens voor de bijgewerkte beleidsvrijstelling. Dit kan een pad zijn naar een bestand met de JSON-metagegevens of de metagegevens als een JSON-tekenreeks.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Name
De naam van de beleidsvrijstelling die moet worden bijgewerkt.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PolicyDefinitionReferenceId
De lijst met referentie-id's voor beleidsdefinities wanneer de gekoppelde beleidstoewijzing voor een beleidsset (initiatief) is.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Pre
Wanneer deze is ingesteld, geeft u aan dat de cmdlet api-versies van de voorlopige versie moet gebruiken wanneer automatisch wordt bepaald welke versie moet worden gebruikt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Scope
Het bereik van de bijgewerkte beleidsuitzondering, bijvoorbeeld /providers/managementGroups/{managementGroupName}, is standaard ingesteld op het huidige abonnement.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]