Set-AzureAclConfig
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 |