Set-AzureAclConfig
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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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, 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.
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 este cmdlet adiciona ou modifica. Os valores válidos são: Permissão 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 este 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ção.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
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 este 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 este 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 este 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 |