Update-AzKeyVaultManagedHsmNetworkRuleSet

Moduł:: Az.KeyVault Module

Zastąp lub zmodyfikuj zestaw reguł sieci zarządzanych modułów HSM (domyślna akcja, obejście i/lub pełna lista reguł ip).

Składnia

ByName (Domyślne)

Update-AzKeyVaultManagedHsmNetworkRuleSet
    [-Name] <String>
    [[-ResourceGroupName] <String>]
    [-DefaultAction <PSManagedHsmNetworkRuleDefaultActionEnum>]
    [-Bypass <PSManagedHsmNetworkRuleBypassEnum>]
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ByInputObject

Update-AzKeyVaultManagedHsmNetworkRuleSet
    [-InputObject] <PSManagedHsm>
    [-DefaultAction <PSManagedHsmNetworkRuleDefaultActionEnum>]
    [-Bypass <PSManagedHsmNetworkRuleBypassEnum>]
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ByResourceId

Update-AzKeyVaultManagedHsmNetworkRuleSet
    [-ResourceId] <String>
    [-DefaultAction <PSManagedHsmNetworkRuleDefaultActionEnum>]
    [-Bypass <PSManagedHsmNetworkRuleBypassEnum>]
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Opis

Aktualizuje konfigurację listy ACL sieci zarządzanego modułu HSM. To polecenie cmdlet zastępuje listę reguł adresów IP po -IpAddressRange podaniu; pomiń parametr , aby zachować istniejącą listę. Reguły sieci wirtualnej nie są obecnie obsługiwane w przypadku zarządzanego modułu HSM. Jeśli określisz jakiekolwiek reguły adresów IP (istniejące zachowane lub nowo podane), musisz zachować/ustawić DefaultAction = Deny; próba zastosowania reguł adresów IP z wynikami DefaultAction Allow błędu.

Typowe scenariusze:

Zbiorcze dodawanie lub usuwanie zakresów adresów IP przez podanie pełnej nowej listy za pośrednictwem polecenia -IpAddressRange.
Wyczyść wszystkie reguły adresów IP, przekazując pustą tablicę: -IpAddressRange @() następnie (opcjonalnie) przejdź do pozycji Zezwalaj.
Zmień tylko wartość DefaultAction lub Bypass podczas opuszczania reguł adresów IP nietkniętych przez pominięcie elementu -IpAddressRange.

Przykłady

Przykład 1. Przełączanie z opcji Zezwalaj na odmowę (włączanie zapory) przy użyciu reguły początkowej

Update-AzKeyVaultManagedHsmNetworkRuleSet -Name myHsm -ResourceGroupName myRg -DefaultAction Deny -IpAddressRange 203.0.113.0/24

Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated


$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {203.0.113.0/24}
ServiceTags         : {}
VirtualNetworkRules : {}

Włącza zaporę i ustawia pojedynczą dozwoloną trasę CIDR.

Przykład 2: Dołączanie reguł przy użyciu polecenia cmdlet Dodaj polecenie cmdlet i wyświetlanie (przy założeniu, że -DefaultAction jest ustawiona na Odmów)

Add-AzKeyVaultManagedHsmNetworkRule -Name myHsm -ResourceGroupName myRg -IpAddressRange 198.51.100.10/32
Update-AzKeyVaultManagedHsmNetworkRuleSet -Name myHsm -ResourceGroupName myRg -Bypass AzureServices -PassThru

(No output but the IP was added to the list)


Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated

$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {198.51.100.10/32}
ServiceTags         : {}
VirtualNetworkRules : {}

Pozostawia istniejącą listę adresów IP bez zmian (nie podano -IpAddressRange) i zmienia tylko ustawienie Obejście.

Przykład 3. Zastępowanie całej listy reguł ip

Update-AzKeyVaultManagedHsmNetworkRuleSet -Name myHsm -ResourceGroupName myRg -IpAddressRange 203.0.113.0/24,198.51.100.0/25 -DefaultAction Deny

Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated


$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {203.0.113.0/24, 198.51.100.0/25}
ServiceTags         : {}
VirtualNetworkRules : {}

Zastępuje bieżące reguły adresów IP dokładnie dwoma zakresami CIDR.

Przykład 4. Wyczyść wszystkie reguły adresów IP, a następnie otwórz dostęp

Update-AzKeyVaultManagedHsmNetworkRuleSet -Name myHsm -ResourceGroupName myRg -IpAddressRange @() -DefaultAction Deny
Update-AzKeyVaultManagedHsmNetworkRuleSet -Name myHsm -ResourceGroupName myRg -DefaultAction Allow

Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated


$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {}
ServiceTags         : {}
VirtualNetworkRules : {}




Name           Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----           ------------------- -------- ---        ----------------- --------------------------------
mhsm1814428918 kv-mhsm-rg          eastus   StandardB1 Succeeded         NotActivated


$h.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Allow
IPRules             : {}
ServiceTags         : {}
VirtualNetworkRules : {}

Wzorzec dwuetapowy: wyczyść reguły, a jednocześnie odmów, a następnie przejdź do pozycji Zezwalaj, gdy lista jest pusta.

Parametry

-Bypass

Określa obejście reguły sieciowej.

Właściwości parametrów

Typ:	PSManagedHsmNetworkRuleBypassEnum
Wartość domyślna:	None
Akceptowane wartości:	None, AzureServices
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	True
Wartość pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:	SwitchParameter
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False
Aliasy:	por

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-DefaultAction

Określa domyślną akcję reguły sieciowej.

Właściwości parametrów

Typ:	PSManagedHsmNetworkRuleDefaultActionEnum
Wartość domyślna:	None
Akceptowane wartości:	Allow, Deny
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	True
Wartość pozostałych argumentów:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametrów

Typ:	IAzureContextContainer
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-InputObject

Zarządzany obiekt HSM.

Właściwości parametrów

Typ:	PSManagedHsm
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

ByInputObject

Pozycja:	0
Obowiązkowy:	True
Wartość z pipeline:	True
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-IpAddressRange

Pełna lista zastępcza zakresów adresów IP CIDR. Pomiń parametr, aby zachować istniejącą listę. Przekaż @() (pustą tablicę), aby wyczyścić wszystkie reguły adresów IP.

Właściwości parametrów

Typ:	String[]
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-Name

Określa nazwę zarządzanego modułu HSM, którego zestaw reguł sieciowych jest modyfikowany.

Właściwości parametrów

Typ:	String
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False
Aliasy:	HsmName

Zbiory parametrów

ByName

Pozycja:	0
Obowiązkowy:	True
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-PassThru

To polecenie cmdlet nie zwraca obiektu domyślnie. Jeśli ten przełącznik zostanie określony, zwraca zaktualizowany zarządzany obiekt HSM.

Właściwości parametrów

Typ:	SwitchParameter
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-ResourceGroupName

Określa nazwę grupy zasobów zarządzanego modułu HSM, którego zestaw reguł sieci jest modyfikowany.

Właściwości parametrów

Typ:	String
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

ByName

Pozycja:	1
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-ResourceId

Identyfikator zasobu zarządzanego modułu HSM.

Właściwości parametrów

Typ:	String
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

ByResourceId

Pozycja:	0
Obowiązkowy:	True
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	True
Wartość pozostałych argumentów:	False

-SubscriptionId

Identyfikator subskrypcji.

Domyślnie polecenia cmdlet są wykonywane w subskrypcji ustawionej w bieżącym kontekście. Jeśli użytkownik określi inną subskrypcję, bieżące polecenie cmdlet zostanie wykonane w subskrypcji określonej przez użytkownika.

Zastępowanie subskrypcji ma zastosowanie tylko w cyklu życia bieżącego polecenia cmdlet. Nie zmienia subskrypcji w kontekście i nie ma wpływu na kolejne polecenia cmdlet.

Właściwości parametrów

Typ:	String
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	True
Wartość pozostałych argumentów:	False

-VirtualNetworkResourceId

(Nieobsługiwane) Reguły sieci wirtualnej nie są obecnie obsługiwane w przypadku zarządzanego modułu HSM.

Właściwości parametrów

Typ:	String[]
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:	SwitchParameter
Wartość domyślna:	None
Wspiera dzikie karty:	False
DontShow:	False
Aliasy:	Wi

Zbiory parametrów

(All)

Pozycja:	Named
Obowiązkowy:	False
Wartość z pipeline:	False
Wartość z pipeline według nazwy właściwości:	False
Wartość pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wyjść

PSManagedHsm

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij przez

Update-AzKeyVaultManagedHsmNetworkRuleSet

Składnia

ByName (Domyślne)

ByInputObject

ByResourceId

Opis

Przykłady

Przykład 1. Przełączanie z opcji Zezwalaj na odmowę (włączanie zapory) przy użyciu reguły początkowej

Przykład 2: Dołączanie reguł przy użyciu polecenia cmdlet Dodaj polecenie cmdlet i wyświetlanie (przy założeniu, że -DefaultAction jest ustawiona na Odmów)

Przykład 3. Zastępowanie całej listy reguł ip

Przykład 4. Wyczyść wszystkie reguły adresów IP, a następnie otwórz dostęp

Parametry

-Bypass

Właściwości parametrów

Zbiory parametrów

-Confirm

Właściwości parametrów

Zbiory parametrów

-DefaultAction

Właściwości parametrów

Zbiory parametrów

-DefaultProfile

Właściwości parametrów

Zbiory parametrów

-InputObject

Właściwości parametrów

Zbiory parametrów

-IpAddressRange

Właściwości parametrów

Zbiory parametrów

-Name

Właściwości parametrów

Zbiory parametrów

-PassThru

Właściwości parametrów

Zbiory parametrów

-ResourceGroupName

Właściwości parametrów

Zbiory parametrów

-ResourceId

Właściwości parametrów

Zbiory parametrów

-SubscriptionId

Właściwości parametrów

Zbiory parametrów

-VirtualNetworkResourceId

Właściwości parametrów

Zbiory parametrów

-WhatIf

Właściwości parametrów

Zbiory parametrów

CommonParameters

Wejścia

PSManagedHsm

String

Nullable<T>

Nullable<T>

Wyjść

PSManagedHsm

Sprzężenie zwrotne