Compartilhar via

Set-AzureAclConfig

  • Referência
Módulo:
Azure

Modifica um objeto de configuração de ACL.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Set-AzureAclConfig
   [-AddRule]
   [-Action] <String>
   [-RemoteSubnet] <String>
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-RemoveRule]
   [-RuleId] <Int32>
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-SetRule]
   [-RuleId] <Int32>
   [[-Action] <String>]
   [[-RemoteSubnet] <String>]
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureAclConfig modifica um objeto de configuração de lista de controle de acesso (ACL) de uma configuração de máquina virtual existente do Azure.

Exemplos

Exemplo 1: Adicionar uma regra a uma nova configuração de ACL

PS C:\> $Acl = New-AzureAclConfig
PS C:\> Set-AzureAclConfig -AddRule -ACL $Acl -Action Permit -RemoteSubnet "172.0.0.0/8" -Order 100 -Description "Permit ACL rule"

O primeiro comando cria uma configuração de ACL e a armazena na variável $Acl.

O segundo comando adiciona uma nova regra à configuração armazenada no $Acl. O comando especifica uma ação, sub-rede, ordem e descrição para a regra.

Exemplo 2: Modificar uma regra em uma configuração de ACL

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -SetRule -RuleId 0 -ACL $Acl -Order 102 -Description "Web endpoint rule"
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

O primeiro comando obtém a máquina virtual chamada VirtualMachine07 no serviço chamado ContosoService usando o cmdlet Get-AzureVM . O comando passa esse objeto para o cmdlet Get-AzureAclConfig usando o operador de pipeline. Esse cmdlet obtém a configuração de ACL para o ponto de extremidade chamado Web. O comando armazena esse objeto de configuração da ACL na variável $Acl.

O segundo comando modifica a regra que tem o ID de 0. O comando altera a ordem e a descrição da regra.

O comando final define o objeto de configuração da ACL para essa máquina virtual usando o cmdlet Set-AzureEndpoint . O comando também atualiza essa máquina virtual.

Exemplo 3: Remover uma regra de uma configuração de ACL

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -RemoveRule -ID 0 -ACL $Acl
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

O primeiro comando armazena um objeto de configuração ACL na variável $Acl. Isso é o mesmo que o exemplo anterior.

O segundo comando remove a regra que tem o ID 0 da configuração da ACL em $Acl.

O comando final define o objeto de configuração da ACL para a máquina virtual e atualiza essa máquina virtual. Isso é o mesmo que o exemplo anterior.

Parâmetros

-ACL

Especifica um objeto de configuração de ACL que esse cmdlet modifica.

Tipo:NetworkAclObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Action

Especifica a ação para a regra que esse cmdlet adiciona ou modifica. Os valores válidos são: Permitir e Negar.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddRule

Indica que esse cmdlet adiciona uma regra à configuração da ACL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para a regra que esse cmdlet adiciona ou modifica.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Parar
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Order

Especifica a ordem de processamento da regra que esse cmdlet adiciona ou modifica.

Tipo:Int32
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoteSubnet

Especifica a sub-rede remota para a regra que esse cmdlet adiciona ou modifica. Especifica um endereço no formato CIDR (Roteamento entre Domínios sem Classe).

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveRule

Indica que esse cmdlet remove uma regra da configuração da ACL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RuleId

Especifica a ID da regra que esse cmdlet remove ou modifica para a configuração da ACL.

Tipo:Int32
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SetRule

Indica que esse cmdlet modifica uma regra na configuração da ACL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False