Set-AzPolicyExemption
Upraví výjimku ze zásad.
Syntax
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
Rutina Set-AzPolicyExemption upraví výjimku zásad. Zadejte výjimku podle ID nebo podle názvu a oboru.
Příklady
Příklad 1: Aktualizace zobrazovaného názvu
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'
První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup. Příkaz uloží tento objekt do proměnné $ResourceGroup. Druhý příkaz získá výjimku zásad s názvem PolicyExemption07 pomocí rutiny Get-AzPolicyExemption. Příkaz uloží tento objekt do $PolicyExemption proměnné. Poslední příkaz aktualizuje zobrazovaný název výjimky zásady pro skupinu prostředků identifikovanou vlastností ResourceId $ResourceGroup.
Příklad 2: Aktualizace data vypršení platnosti
$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth
První příkaz získá aktuální datum a čas pomocí rutiny Get-Date a přidá 1 měsíc k aktuálnímu datu. Tento objekt uloží do proměnné $NextMonth. Druhý příkaz získá výjimku zásad s názvem PolicyExemption07 pomocí rutiny Get-AzPolicyExemption. Příkaz uloží tento objekt do $PolicyExemption proměnné. Poslední příkaz aktualizuje datum vypršení platnosti výjimky zásady u výchozího předplatného.
Příklad 3: Vymazání data vypršení platnosti
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration
První příkaz získá výjimku zásad s názvem PolicyExemption07 pomocí rutiny Get-AzPolicyExemption. Příkaz uloží tento objekt do $PolicyExemption proměnné. Druhý příkaz vymaže datum vypršení platnosti výjimky zásady u výchozího předplatného. Aktualizovaná výjimka nikdy nevyprší.
Příklad 4: Aktualizace kategorie vypršení platnosti
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated
První příkaz získá výjimku zásad s názvem PolicyExemption07 pomocí rutiny Get-AzPolicyExemption. Příkaz uloží tento objekt do $PolicyExemption proměnné. Druhý příkaz aktualizuje kategorii vypršení platnosti výjimky ze zásady u výchozího předplatného. Aktualizovaná výjimka nikdy nevyprší.
Parametry
-ApiVersion
Při nastavení označuje verzi rozhraní API poskytovatele prostředků, která se má použít. Pokud není zadána, verze rozhraní API se automaticky určí jako nejnovější dostupná.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearExpiration
Pokud je tato možnost nastavená, vymaže datum a čas vypršení platnosti u aktualizované výjimky zásad.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Popis aktualizované výjimky ze zásad.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayName
Zobrazovaný název aktualizované výjimky ze zásad.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExemptionCategory
Kategorie výjimky ze zásad aktualizované výjimky ze zásad. Možné hodnoty jsou zřeknutí se a zmírnění.
Type: | String |
Accepted values: | Waiver, Mitigated |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExpiresOn
Datum a čas vypršení platnosti (ve formátu UTC ISO 8601 rrrr-MM-ddTHH:mm:ssZ) aktualizované výjimky ze zásad.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Plně kvalifikované ID výjimky zásad, které se má aktualizovat, včetně oboru, například /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Objekt výjimky zásad pro aktualizaci výstupu z jiné rutiny.
Type: | PsPolicyExemption |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Metadata
Metadata pro aktualizovanou výjimku ze zásad. Může to být cesta k souboru obsahujícímu JSON metadat nebo metadata jako řetězec JSON.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Název výjimky zásady, která se má aktualizovat.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionReferenceId
Seznam ID referenčního odkazu definice zásad, pokud je přidružené přiřazení zásady pro sadu zásad (iniciativu).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
Při nastavení označuje, že rutina by měla při automatickém určování verze, kterou verzi použít, používat předběžné verze rozhraní API.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Rozsah aktualizované výjimky ze zásad, například /providers/managementGroups/{managementGroupName}, se standardně používá k aktuálnímu předplatnému.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Výstupy
Azure PowerShell
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro