Compartir a través de

Set-AzureAclConfig

  • Referencia
Módulo:
Azure

Modifica un objeto de configuración de ACL.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet Set-AzureAclConfig modifica un objeto de configuración de lista de control de acceso (ACL) desde una configuración de máquina virtual de Azure existente.

Ejemplos

Ejemplo 1: Agregar una regla a una nueva configuración 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"

El primer comando crea una configuración de ACL y, a continuación, la almacena en la variable $Acl.

El segundo comando agrega una nueva regla a la configuración almacenada en $Acl. El comando especifica una acción, subred, orden y descripción para la regla.

Ejemplo 2: Modificación de una regla en una configuración 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

El primer comando obtiene la máquina virtual denominada VirtualMachine07 en el servicio denominado ContosoService mediante el cmdlet Get-AzureVM . El comando pasa ese objeto al cmdlet Get-AzureAclConfig mediante el operador de canalización. Ese cmdlet obtiene la configuración de ACL para el punto de conexión denominado Web. El comando almacena el objeto de configuración de ACL en la variable $Acl.

El segundo comando modifica la regla que tiene el identificador 0. El comando cambia el orden y la descripción de la regla.

El comando final establece el objeto de configuración de ACL para esa máquina virtual mediante el cmdlet Set-AzureEndpoint . El comando también actualiza esa máquina virtual.

Ejemplo 3: Quitar una regla de una configuración 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

El primer comando almacena un objeto de configuración de ACL en la variable $Acl. Este es el mismo que el ejemplo anterior.

El segundo comando quita la regla que tiene el identificador 0 de la configuración de ACL en $Acl.

El comando final establece el objeto de configuración de ACL para la máquina virtual y actualiza esa máquina virtual. Este es el mismo que el ejemplo anterior.

Parámetros

-ACL

Especifica un objeto de configuración de ACL que modifica este cmdlet.

Tipo:NetworkAclObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Action

Especifica la acción de la regla que este cmdlet agrega o modifica. Los valores válidos son: Permitir y Denegar.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AddRule

Indica que este cmdlet agrega una regla a la configuración de ACL.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción de la regla que este cmdlet agrega o modifica.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Order

Especifica el orden de procesamiento de la regla que este cmdlet agrega o modifica.

Tipo:Int32
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoteSubnet

Especifica la subred remota para la regla que este cmdlet agrega o modifica. Especifica una dirección en formato Enrutamiento de interdominios sin clases (CIDR).

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveRule

Indica que este cmdlet quita una regla de la configuración de ACL.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RuleId

Especifica el identificador de la regla que este cmdlet quita o modifica para la configuración de ACL.

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SetRule

Indica que este cmdlet modifica una regla en la configuración de ACL.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False