Dela via

Set-AzureAclConfig

  • Referens
Modul:
Azure

Ändrar ett ACL-konfigurationsobjekt.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

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

Cmdleten Set-AzureAclConfig ändrar ett konfigurationsobjekt för åtkomstkontrollistor (ACL) från en befintlig konfiguration av virtuella Azure-datorer.

Exempel

Exempel 1: Lägga till en regel i en ny ACL-konfiguration

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"

Det första kommandot skapar en ACL-konfiguration och lagrar den sedan i variabeln $Acl.

Det andra kommandot lägger till en ny regel i konfigurationen som lagras i $Acl. Kommandot anger en åtgärd, ett undernät, en order och en beskrivning för regeln.

Exempel 2: Ändra en regel i en ACL-konfiguration

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

Det första kommandot hämtar den virtuella datorn med namnet VirtualMachine07 i tjänsten ContosoService med hjälp av cmdleten Get-AzureVM . Kommandot skickar objektet till cmdleten Get-AzureAclConfig med hjälp av pipelineoperatorn. Den cmdleten hämtar ACL-konfigurationen för slutpunkten med namnet Web. Kommandot lagrar det ACL-konfigurationsobjektet i variabeln $Acl.

Det andra kommandot ändrar regeln som har ID:t 0. Kommandot ändrar ordningen och beskrivningen av regeln.

Det sista kommandot anger ACL-konfigurationsobjektet för den virtuella datorn med hjälp av cmdleten Set-AzureEndpoint . Kommandot uppdaterar även den virtuella datorn.

Exempel 3: Ta bort en regel från en ACL-konfiguration

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

Det första kommandot lagrar ett ACL-konfigurationsobjekt i variabeln $Acl. Detta är samma som i föregående exempel.

Det andra kommandot tar bort regeln som har ID 0 från ACL-konfigurationen i $Acl.

Det sista kommandot anger ACL-konfigurationsobjektet för den virtuella datorn och uppdaterar den virtuella datorn. Detta är samma som i föregående exempel.

Parametrar

-ACL

Anger ett ACL-konfigurationsobjekt som den här cmdleten ändrar.

Type:NetworkAclObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Action

Anger åtgärden för regeln som den här cmdleten lägger till eller ändrar. Giltiga värden är: Tillåt och Neka.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AddRule

Anger att den här cmdleten lägger till en regel i ACL-konfigurationen.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Anger en beskrivning av regeln som den här cmdleten lägger till eller ändrar.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De godtagbara värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Anger en informationsvariabel.

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

-Order

Anger bearbetningsordningen för regeln som den här cmdleten lägger till eller ändrar.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoteSubnet

Anger fjärrundernätet för regeln som den här cmdleten lägger till eller ändrar. Anger en adress i CIDR-format (Classless Interdomain Routing).

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRule

Anger att den här cmdleten tar bort en regel från ACL-konfigurationen.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleId

Anger ID för regeln som den här cmdleten tar bort eller ändrar för ACL-konfigurationen.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SetRule

Anger att den här cmdleten ändrar en regel i ACL-konfigurationen.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False