Set-AzureAclConfig

Syntax

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

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

Set-AzureAclConfig
   [-RuleId] <Int32>
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-RemoveRule]
   [<CommonParameters>]

Description

The Set-AzureAclConfig cmdlet modifies an access control list (ACL) configuration object from an existing Azure virtual machine configuration.

Examples

Example 1: Add a rule to a new ACL configuration

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"

The first command creates an ACL configuration, and then stores it in the $Acl variable.

The second command adds a new rule to the configuration stored in $Acl. The command specifies an action, subnet, order, and description for the rule.

Example 2: Modify a rule in an ACL configuration

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

The first command gets the virtual machine named VirtualMachine07 in the service named ContosoService by using the Get-AzureVM cmdlet. The command passes that object to the Get-AzureAclConfig cmdlet by using the pipeline operator. That cmdlet gets the ACL configuration for the endpoint named Web. The command stores that ACL configuration object in the $Acl variable.

The second command modifies the rule that has the ID of 0. The command changes the order and the description of the rule.

The final command sets the ACL configuration object for that virtual machine by using the Set-AzureEndpoint cmdlet. The command also updates that virtual machine.

Example 3: Remove a rule from an ACL configuration

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

The first command stores an ACL configuration object in the $Acl variable. This is the same as the previous example.

The second command removes the rule that has the ID 0 from the ACL configuration in $Acl.

The final command sets the ACL configuration object for the virtual machine and updates that virtual machine. This is the same as the previous example.

Required Parameters

Optional Parameters

Related Links

• Get-AzureAclConfig
• Get-AzureVM
• New-AzureAclConfig
• Remove-AzureAclConfig
• Set-AzureEndpoint
• Update-AzureVM