Partager via

Set-AzureAclConfig

  • Référence
Module:
Azure

Modifie un objet de configuration ACL.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

L’applet de commande Set-AzureAclConfig modifie un objet de configuration de liste de contrôle d’accès (ACL) à partir d’une configuration de machine virtuelle Azure existante.

Exemples

Exemple 1 : Ajouter une règle à une nouvelle configuration de liste de contrôle d’accès

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"

La première commande crée une configuration ACL, puis la stocke dans la variable $Acl.

La deuxième commande ajoute une nouvelle règle à la configuration stockée dans $Acl. La commande spécifie une action, un sous-réseau, un ordre et une description pour la règle.

Exemple 2 : Modifier une règle dans une configuration de liste de contrôle d’accès

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

La première commande obtient la machine virtuelle nommée VirtualMachine07 dans le service nommé ContosoService à l’aide de l’applet de commande Get-AzureVM . La commande transmet cet objet à l’applet de commande Get-AzureAclConfig à l’aide de l’opérateur de pipeline. Cette applet de commande obtient la configuration de la liste de contrôle d’accès pour le point de terminaison nommé Web. La commande stocke cet objet de configuration ACL dans la variable $Acl.

La deuxième commande modifie la règle qui a l’ID de 0. La commande modifie l’ordre et la description de la règle.

La commande finale définit l’objet de configuration ACL pour cette machine virtuelle à l’aide de l’applet de commande Set-AzureEndpoint . La commande met également à jour cette machine virtuelle.

Exemple 3 : Supprimer une règle d’une configuration de liste de contrôle d’accès

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

La première commande stocke un objet de configuration de liste de contrôle d’accès dans la variable $Acl. Il s’agit de la même chose que l’exemple précédent.

La deuxième commande supprime la règle qui a l’ID 0 de la configuration ACL dans $Acl.

La commande finale définit l’objet de configuration ACL pour la machine virtuelle et met à jour cette machine virtuelle. Il s’agit de la même chose que l’exemple précédent.

Paramètres

-ACL

Spécifie un objet de configuration de liste de contrôle d’accès que cette applet de commande modifie.

Type:NetworkAclObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Action

Spécifie l’action de la règle que cette applet de commande ajoute ou modifie. Les valeurs valides sont : Autoriser et Refuser.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AddRule

Indique que cette applet de commande ajoute une règle à la configuration de la liste de contrôle d’accès.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la règle que cette applet de commande ajoute ou modifie.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Order

Spécifie l’ordre de traitement de la règle que cette applet de commande ajoute ou modifie.

Type:Int32
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoteSubnet

Spécifie le sous-réseau distant de la règle que cette applet de commande ajoute ou modifie. Spécifie une adresse au format ROUTAGE CIDR (CLASSLESS INTERDOMAIN ROUTING) (CIDR).

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveRule

Indique que cette applet de commande supprime une règle de la configuration de la liste de contrôle d’accès.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RuleId

Spécifie l’ID de la règle que cette applet de commande supprime ou modifie pour la configuration de la liste de contrôle d’accès.

Type:Int32
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SetRule

Indique que cette applet de commande modifie une règle dans la configuration de la liste de contrôle d’accès.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False