Update-AzPolicyExemption

Moduł:

Az.Resources

Ta operacja aktualizuje wykluczenie zasad z podanym zakresem i nazwą.

Składnia

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Ta operacja aktualizuje wykluczenie zasad z podanym zakresem i nazwą.

Przykłady

Przykład 1. Aktualizowanie nazwy wyświetlanej

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-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 z 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'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth

Pierwsze 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'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

Pierwsze 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'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated

Pierwsze 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.

Pierwsze 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 5. Aktualizowanie selektora zasobów

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

Pierwsze polecenie tworzy obiekt selektora zasobów, który będzie używany do określania wykluczenia, powinien dotyczyć tylko zasobów w lokalizacjach innych niż Wschodnie stany USA lub Wschodnie stany USA 2 i przechowuje je w zmiennej $ResourceSelector. Ostatnie polecenie aktualizuje wykluczenie zasad o nazwie VirtualMachineExemption za pomocą selektora zasobów określonego przez $ResourceSelector.

Przykład 6: [Backcompat] Wyczyść datę wygaśnięcia

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

Pierwsze 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.

Parametry

-AssignmentScopeValidation

Opcja sprawdzania, czy wykluczenie znajduje się w zakresie przypisania, czy też jest w jego zakresie.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-BackwardCompatible

Powoduje, że polecenie cmdlet zwraca artefakty przy użyciu starszego formatu umieszczania właściwości specyficznych dla zasad w obiekcie torby właściwości.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ClearExpiration

Wskazuje, czy wyczyścić datę i godzinę wygaśnięcia 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

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Description

Ten komunikat będzie częścią odpowiedzi w przypadku naruszenia 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 przypisania zasad.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ExemptionCategory

Kategoria wykluczenia z zasad

Typ:	String
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) wykluczenia z 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 przypisania zasad do usunięcia. Użyj formatu "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Typ:	String
Aliasy:	ResourceId
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-InputObject

Typ:	IPolicyExemption
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Metadata

Metadane przypisania zasad. Metadane są otwartym obiektem końcowym i zazwyczaj jest kolekcją par klucz-wartość.

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.

Typ:	String
Aliasy:	PolicyExemptionName
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

-ResourceSelector

Lista selektorów zasobów do filtrowania zasad według właściwości zasobów.

Typ:	IResourceSelector[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Scope

Zakres wykluczenia z zasad. Prawidłowe zakresy to: grupa zarządzania (format: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), subskrypcja (format: "/subscriptions/{subscriptionId}"), grupa zasobów (format: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}", lub zasób (format: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}"

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, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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

IPolicyExemption

SwitchParameter

Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String

String[]

Dane wyjściowe

IPolicyExemption

Uwagi

ALIASY

Set-AzPolicyExemption