Condividi tramite

Set-AzureAclConfig

  • Riferimento
Modulo:
Azure

Modifica un oggetto di configurazione ACL.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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>]

Descrizione

Il cmdlet Set-AzureAclConfig modifica un oggetto di configurazione dell'elenco di controllo di accesso (ACL) da una configurazione di macchina virtuale di Azure esistente.

Esempio

Esempio 1: Aggiungere una regola a una nuova configurazione 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"

Il primo comando crea una configurazione ACL e quindi la archivia nella variabile $Acl.

Il secondo comando aggiunge una nuova regola alla configurazione archiviata in $Acl. Il comando specifica un'azione, una subnet, un ordine e una descrizione per la regola.

Esempio 2: Modificare una regola in una configurazione 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

Il primo comando ottiene la macchina virtuale denominata VirtualMachine07 nel servizio denominato ContosoService usando il cmdlet Get-AzureVM . Il comando passa tale oggetto al cmdlet Get-AzureAclConfig usando l'operatore pipeline. Questo cmdlet ottiene la configurazione ACL per l'endpoint denominato Web. Il comando archivia l'oggetto di configurazione ACL nella variabile $Acl.

Il secondo comando modifica la regola con ID 0. Il comando modifica l'ordine e la descrizione della regola.

Il comando finale imposta l'oggetto di configurazione ACL per la macchina virtuale usando il cmdlet Set-AzureEndpoint . Il comando aggiorna anche la macchina virtuale.

Esempio 3: Rimuovere una regola da una configurazione 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

Il primo comando archivia un oggetto di configurazione ACL nella variabile $Acl. Questo è lo stesso dell'esempio precedente.

Il secondo comando rimuove la regola con ID 0 dalla configurazione ACL in $Acl.

Il comando finale imposta l'oggetto di configurazione ACL per la macchina virtuale e aggiorna la macchina virtuale. Questo è lo stesso dell'esempio precedente.

Parametri

-ACL

Specifica un oggetto di configurazione ACL modificato da questo cmdlet.

Tipo:NetworkAclObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Action

Specifica l'azione per la regola aggiunta o modificata da questo cmdlet. I valori validi sono: Permit e Deny.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddRule

Indica che questo cmdlet aggiunge una regola alla configurazione ACL.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la regola aggiunta o modificata da questo cmdlet.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Order

Specifica l'ordine di elaborazione per la regola che questo cmdlet aggiunge o modifica.

Tipo:Int32
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoteSubnet

Specifica la subnet remota per la regola aggiunta o modificata da questo cmdlet. Specifica un indirizzo in formato CIDR (Classless Interdomain Routing).

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveRule

Indica che questo cmdlet rimuove una regola dalla configurazione ACL.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RuleId

Specifica l'ID della regola che questo cmdlet rimuove o modifica per la configurazione ACL.

Tipo:Int32
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SetRule

Indica che questo cmdlet modifica una regola nella configurazione ACL.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False