Set-AzureAclConfig

Referência

Módulo:: Azure

Modifica um objeto de configuração de ACL.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

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 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 da ACL para o ponto de extremidade chamado Web. O comando armazena esse objeto de configuração de 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.

Type:	NetworkAclObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Action

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRule

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informação.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Order

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

Type:	Int32
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRule

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RuleId

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

Type:	Int32
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SetRule

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False