Partilhar via

Set-AzureAclConfig

  • Referência
Módulo:
Azure

Modifica um objeto de configuração da ACL.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

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

Syntax

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, em seguida, armazena-a 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 da 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 a 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 da ACL na variável $Acl. Este é o mesmo exemplo anterior.

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

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

Parâmetros

-ACL

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

Tipo:NetworkAclObject
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-Action

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

Tipo:String
Position:0
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-AddRule

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Tipo:String
Position:3
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Order

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

Tipo:Int32
Position:2
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoteSubnet

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

Tipo:String
Position:1
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRule

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleId

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

Tipo:Int32
Position:0
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-SetRule

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

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False