Add-AzKeyVaultManagedHsmNetworkRule

Add-AzKeyVaultManagedHsmNetworkRule
    [-Name] <String>
    [[-ResourceGroupName] <String>]
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Add-AzKeyVaultManagedHsmNetworkRule
    [-InputObject] <PSManagedHsm>
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Add-AzKeyVaultManagedHsmNetworkRule
    [-ResourceId] <String>
    [-IpAddressRange <String[]>]
    [-VirtualNetworkResourceId <String[]>]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

하나 이상의 CIDR IP 주소 범위를 관리형 HSM 네트워크 ACL 목록에 추가합니다. 이 cmdlet은 병합을 수행합니다(기존 IP 규칙을 유지하고 새 규칙을 추가하여 대/소문자를 구분하지 않고 중복을 무시). 가상 네트워크 규칙은 현재 관리형 HSM에 대해 지원되지 않습니다. 오류를 발생시키려고 -VirtualNetworkResourceId 시도하면 오류가 발생합니다. 관리형 HSM 서비스는 IP 규칙이 있을 때 필요합니다 DefaultActionDeny . 현재 방화벽이 열려 있는 경우(Allow) 이 cmdlet이 throw되고 먼저 실행 Update-AzKeyVaultManagedHsmNetworkRuleSet -DefaultAction Deny하도록 지시합니다.

일반적인 워크플로:

1. 또는 .를 사용하여 DefaultAction 거부(선택적으로 첫 번째 IP 추가)를 설정하여 방화벽을 New-AzKeyVaultManagedHsm-NetworkRuleSetUpdate-AzKeyVaultManagedHsmNetworkRuleSet사용하도록 설정합니다.
2. 이 cmdlet을 사용하여 IP 범위를 더 추가합니다.

Add-AzKeyVaultManagedHsmNetworkRule -Name $myHsm -ResourceGroupName $myRg -IpAddressRange 203.0.113.0/24

(No Output but the IPRules are updated)

하나의 CIDR 범위를 추가합니다. 기존 규칙은 유지됩니다.

Add-AzKeyVaultManagedHsmNetworkRule -Name $myHsm -ResourceGroupName $myRg -IpAddressRange 203.0.113.0/24,198.51.100.10/32 -PassThru

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


$hsm.OriginalManagedHsm.Properties.NetworkAcls
Bypass              : AzureServices
DefaultAction       : Deny
IPRules             : {203.0.113.0/24, 198.51.100.10/32}
ServiceTags         : {}
VirtualNetworkRules : {}

지정된 경우 두 개의 범위를 추가한 다음 Managed HSM 개체를 -PassThru 출력합니다.

Get-AzKeyVaultManagedHsm -Name $myHsm -ResourceGroupName $myRg | Add-AzKeyVaultManagedHsmNetworkRule -IpAddressRange 198.51.100.0/25

(No Output but the IPRules are updated)

파이프라인 폼(-InputObject)을 사용합니다.

# First open firewall (for illustration – not recommended long term)
Update-AzKeyVaultManagedHsmNetworkRuleSet -Name $myHsm -ResourceGroupName $myRg -DefaultAction Allow

# This next command will throw until you set DefaultAction back to Deny
Add-AzKeyVaultManagedHsmNetworkRule -Name myHsm -ResourceGroupName myRg -IpAddressRange 192.0.2.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       : Allow
IPRules             : {}
ServiceTags         : {}
VirtualNetworkRules : {}


Add-AzKeyVaultManagedHsmNetworkRule: Cannot add IP network rules while DefaultAction is Allow. Run Update-AzKeyVaultManagedHsmNetworkRuleSet -Name <name> -DefaultAction Deny first, then add IP rules.

DefaultAction이 허용되는 동안 IP 규칙을 추가하지 못하게 하는 유효성 검사를 보여 줍니다.

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.