Atualiza a configuração da ACL de rede do HSM gerenciado. Este cmdlet SUBSTITUI a lista de regras IP quando -IpAddressRange é fornecido, omite o parâmetro para manter a lista existente. Atualmente, não há suporte para regras de rede virtual para HSM gerenciado. Se você especificar quaisquer regras de IP (existentes retidas ou recém-fornecidas), você deve manter / definir DefaultAction = Deny; tentando aplicar regras de IP com DefaultAction Allow resultados em um erro.
Cenários típicos:
Adicione ou remova intervalos de IP em massa fornecendo uma nova lista completa via -IpAddressRange.
Limpe todas as regras de IP passando uma matriz vazia: em seguida, -IpAddressRange @() (opcionalmente) alterne para Permitir.
Altere apenas DefaultAction ou Bypass deixando as regras de IP intactas omitindo -IpAddressRange.
Exemplos
Exemplo 1: Alternar de Permitir para Negar (ativar firewall) com uma regra inicial
(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 : {}
Deixa a lista de IP existente intacta (nenhuma -IpAddressRange fornecida) e altera apenas a configuração Bypass.
Padrão de duas etapas: regras claras enquanto ainda nega e, em seguida, alterne para Permitir quando a lista estiver vazia.
Parâmetros
-Bypass
Especifica o desvio da regra de rede.
Propriedades dos parâmetros
Tipo:
PSManagedHsmNetworkRuleBypassEnum
Valor padrão:
None
Valores aceites:
None, AzureServices
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
True
Valor dos argumentos restantes:
False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Pseudónimos:
Cf.
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-DefaultAction
Especifica a ação padrão da regra de rede.
Propriedades dos parâmetros
Tipo:
PSManagedHsmNetworkRuleDefaultActionEnum
Valor padrão:
None
Valores aceites:
Allow, Deny
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
True
Valor dos argumentos restantes:
False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo:
IAzureContextContainer
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Pseudónimos:
AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-InputObject
Objeto HSM gerenciado.
Propriedades dos parâmetros
Tipo:
PSManagedHsm
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
ByInputObject
Posição:
0
Obrigatório:
True
Valor do pipeline:
True
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-IpAddressRange
Lista completa de substituição de intervalos CIDR IP. Omitir parâmetro para manter a lista existente. Passe @() (matriz vazia) para limpar todas as regras de IP.
Propriedades dos parâmetros
Tipo:
String[]
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-Name
Especifica o nome de um HSM gerenciado cujo conjunto de regras de rede está sendo modificado.
Propriedades dos parâmetros
Tipo:
String
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Pseudónimos:
HsmName
Conjuntos de parâmetros
ByName
Posição:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-PassThru
Este cmdlet não retorna um objeto por padrão.
Se essa opção for especificada, ela retornará o objeto HSM gerenciado atualizado.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-ResourceGroupName
Especifica o nome do grupo de recursos do HSM gerenciado cujo conjunto de regras de rede está sendo modificado.
Propriedades dos parâmetros
Tipo:
String
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
ByName
Posição:
1
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-ResourceId
ID do recurso HSM gerenciado.
Propriedades dos parâmetros
Tipo:
String
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
ByResourceId
Posição:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
True
Valor dos argumentos restantes:
False
-SubscriptionId
O ID da assinatura.
Por padrão, os cmdlets são executados na assinatura definida no contexto atual.
Se o usuário especificar outra assinatura, o cmdlet atual será executado na assinatura especificada pelo usuário.
A substituição de assinaturas só entra em vigor durante o ciclo de vida do cmdlet atual.
Ele não altera a assinatura no contexto e não afeta cmdlets subsequentes.
Propriedades dos parâmetros
Tipo:
String
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
True
Valor dos argumentos restantes:
False
-VirtualNetworkResourceId
(Não suportado) Atualmente, não há suporte para regras de rede virtual para HSM gerenciado.
Propriedades dos parâmetros
Tipo:
String[]
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo:
SwitchParameter
Valor padrão:
None
Suporta curingas:
False
DontShow:
False
Pseudónimos:
Wi
Conjuntos de parâmetros
(All)
Posição:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline por nome da propriedade:
False
Valor dos argumentos restantes:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
A fonte deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever issues e pull requests. Para mais informações, consulte o nosso guia para colaboradores.
