Delen via

Set-AzureAclConfig

  • Referentie
Module:
Azure

Hiermee wijzigt u een ACL-configuratieobject.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met 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

Met de cmdlet Set-AzureAclConfig wordt een ACL-configuratieobject (Access Control List) gewijzigd vanuit een bestaande configuratie van een virtuele Azure-machine.

Voorbeelden

Voorbeeld 1: Een regel toevoegen aan een nieuwe ACL-configuratie

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"

Met de eerste opdracht wordt een ACL-configuratie gemaakt en vervolgens opgeslagen in de $Acl variabele.

Met de tweede opdracht wordt een nieuwe regel toegevoegd aan de configuratie die is opgeslagen in $Acl. Met de opdracht geeft u een actie, subnet, volgorde en beschrijving voor de regel op.

Voorbeeld 2: Een regel wijzigen in een ACL-configuratie

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

Met de eerste opdracht wordt de virtuele machine met de naam VirtualMachine07 opgehaald in de service met de naam ContosoService met behulp van de Get-AzureVM-cmdlet . De opdracht geeft dat object door aan de cmdlet Get-AzureAclConfig met behulp van de pijplijnoperator. Met deze cmdlet wordt de ACL-configuratie opgehaald voor het eindpunt met de naam Web. Met de opdracht wordt dat ACL-configuratieobject opgeslagen in de $Acl variabele.

Met de tweede opdracht wijzigt u de regel met de id van 0. De opdracht wijzigt de volgorde en de beschrijving van de regel.

Met de laatste opdracht wordt het ACL-configuratieobject voor die virtuele machine ingesteld met behulp van de cmdlet Set-AzureEndpoint . Met de opdracht wordt ook die virtuele machine bijgewerkt.

Voorbeeld 3: Een regel verwijderen uit een ACL-configuratie

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

Met de eerste opdracht wordt een ACL-configuratieobject opgeslagen in de $Acl variabele. Dit is hetzelfde als in het vorige voorbeeld.

Met de tweede opdracht verwijdert u de regel met de id 0 uit de ACL-configuratie in $Acl.

Met de laatste opdracht wordt het ACL-configuratieobject ingesteld voor de virtuele machine en wordt die virtuele machine bijgewerkt. Dit is hetzelfde als in het vorige voorbeeld.

Parameters

-ACL

Hiermee geeft u een ACL-configuratieobject op dat door deze cmdlet wordt gewijzigd.

Type:NetworkAclObject
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Action

Hiermee geeft u de actie op voor de regel die door deze cmdlet wordt toegevoegd of gewijzigd. Geldige waarden zijn: Toestaan en Weigeren.

Type:String
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-AddRule

Geeft aan dat deze cmdlet een regel toevoegt aan de ACL-configuratie.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Hiermee geeft u een beschrijving op voor de regel die met deze cmdlet wordt toegevoegd of gewijzigd.

Type:String
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliases:infa
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliases:iv
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Order

Hiermee geeft u de verwerkingsvolgorde op voor de regel die door deze cmdlet wordt toegevoegd of gewijzigd.

Type:Int32
Position:2
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoteSubnet

Hiermee geeft u het externe subnet op voor de regel die door deze cmdlet wordt toegevoegd of gewijzigd. Hiermee geeft u een adres in CIDR-indeling (Classless Interdomain Routing) op.

Type:String
Position:1
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRule

Geeft aan dat deze cmdlet een regel verwijdert uit de ACL-configuratie.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleId

Hiermee geeft u de id op van de regel die met deze cmdlet wordt verwijderd of gewijzigd voor de ACL-configuratie.

Type:Int32
Position:0
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-SetRule

Geeft aan dat deze cmdlet een regel wijzigt in de ACL-configuratie.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False