Set-AzPolicyExemption
Modyfikuje wykluczenie z zasad.
Składnia
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>] Opis
Polecenie cmdlet Set-AzPolicyExemption modyfikuje wykluczenie z zasad. Określ wykluczenie według identyfikatora lub nazwy i zakresu.
Przykłady
Przykład 1. Aktualizowanie nazwy wyświetlanej
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'Pierwsze polecenie pobiera grupę zasobów o nazwie ResourceGroup11 przy użyciu polecenia cmdlet Get-AzResourceGroup. Polecenie przechowuje ten obiekt w zmiennej $ResourceGroup. Drugie polecenie pobiera wykluczenie zasad o nazwie PolicyExemption07 przy użyciu polecenia cmdlet Get-AzPolicyExemption. Polecenie przechowuje ten obiekt w zmiennej $PolicyExemption. Końcowe polecenie aktualizuje nazwę wyświetlaną wykluczenia zasad w grupie zasobów zidentyfikowanej przez właściwość ResourceId $ResourceGroup.
Przykład 2. Aktualizowanie daty wygaśnięcia o godzinie
$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonthPierwsze polecenie pobiera bieżącą godzinę daty przy użyciu polecenia cmdlet Get-Date i dodaj 1 miesiąc do bieżącej godziny daty Polecenie przechowuje ten obiekt w zmiennej $NextMonth. Drugie polecenie pobiera wykluczenie zasad o nazwie PolicyExemption07 przy użyciu polecenia cmdlet Get-AzPolicyExemption. Polecenie przechowuje ten obiekt w zmiennej $PolicyExemption. Ostatnie polecenie aktualizuje datę wygaśnięcia wykluczenia z zasad w domyślnej subskrypcji.
Przykład 3. Czyszczenie daty wygaśnięcia o godzinie
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpirationPierwsze polecenie pobiera wykluczenie zasad o nazwie PolicyExemption07 przy użyciu polecenia cmdlet Get-AzPolicyExemption. Polecenie przechowuje ten obiekt w zmiennej $PolicyExemption. Drugie polecenie czyści datę wygaśnięcia wykluczenia z zasad w domyślnej subskrypcji. Zaktualizowane wykluczenie nigdy nie wygaśnie.
Przykład 4. Aktualizowanie kategorii wygasania
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory MitigatedPierwsze polecenie pobiera wykluczenie zasad o nazwie PolicyExemption07 przy użyciu polecenia cmdlet Get-AzPolicyExemption. Polecenie przechowuje ten obiekt w zmiennej $PolicyExemption. Drugie polecenie aktualizuje kategorię wygaśnięcia wykluczenia z zasad w domyślnej subskrypcji. Zaktualizowane wykluczenie nigdy nie wygaśnie.
Parametry
-ApiVersion
Po ustawieniu wskazuje wersję interfejsu API dostawcy zasobów do użycia. Jeśli nie zostanie określona, wersja interfejsu API zostanie automatycznie określona jako najnowsza dostępna.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ClearExpiration
W przypadku ustawienia ten przełącznik czyści datę i godzinę wygaśnięcia zaktualizowanego wykluczenia z zasad.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Opis zaktualizowanego wykluczenia zasad.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayName
Nazwa wyświetlana zaktualizowanego wykluczenia zasad.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ExemptionCategory
Kategoria wykluczenia zasad ze zaktualizowanym wykluczeniem z zasad. Możliwe wartości to Zrzeczenie się i Złagodzone.
| Typ: | String |
| Dopuszczalne wartości: | Waiver, Mitigated |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ExpiresOn
Data i godzina wygaśnięcia (w formacie UTC ISO 8601 rrrr-MM-ddTHH:mm:ssZ) zaktualizowanego wykluczenia zasad.
| Typ: | Nullable<T>[DateTime] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Id
Identyfikator wykluczenia z w pełni kwalifikowanych zasad do zaktualizowania, w tym zakres, np. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
| Typ: | String |
| Aliasy: | ResourceId |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-InputObject
Obiekt wykluczania zasad w celu zaktualizowania danych wyjściowych z innego polecenia cmdlet.
| Typ: | PsPolicyExemption |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Metadata
Metadane zaktualizowanego wykluczenia zasad. Może to być ścieżka do pliku zawierającego kod JSON metadanych lub metadanych jako ciąg JSON.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa wykluczenia z zasad do zaktualizowania.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PolicyDefinitionReferenceId
Lista identyfikatorów referencyjnych definicji zasad, gdy skojarzone przypisanie zasad dotyczy zestawu zasad (inicjatywy).
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Pre
Po ustawieniu wskazuje, że polecenie cmdlet powinno używać wersji interfejsu API wersji wstępnej podczas automatycznego określania, która wersja ma być używana.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Scope
Zakres zaktualizowanego wykluczenia zasad, np. /providers/managementGroups/{managementGroupName}, domyślnie jest to bieżąca subskrypcja.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]