Set-AzureAclConfig

Référence

Module:: Azure

Modifie un objet de configuration ACL.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

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

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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Order

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

Type:	Int32
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 CIDR (Classless Interdomain Routing).

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False