Sdílet prostřednictvím

Set-AzureAclConfig

  • Reference
Modul:
Azure

Upraví objekt konfigurace seznamu ACL.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

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

Rutina Set-AzureAclConfig upraví objekt konfigurace seznamu řízení přístupu (ACL) z existující konfigurace virtuálního počítače Azure.

Příklady

Příklad 1: Přidání pravidla do nové konfigurace seznamu 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"

První příkaz vytvoří konfiguraci seznamu ACL a pak ji uloží do proměnné $Acl.

Druhý příkaz přidá nové pravidlo do konfigurace uložené v $Acl. Příkaz určuje akci, podsíť, pořadí a popis pravidla.

Příklad 2: Úprava pravidla v konfiguraci seznamu 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

První příkaz získá virtuální počítač s názvem VirtualMachine07 ve službě s názvem ContosoService pomocí rutiny Get-AzureVM . Příkaz předá tento objekt rutině Get-AzureAclConfig pomocí operátoru kanálu. Tato rutina získá konfiguraci seznamu ACL pro koncový bod s názvem Web. Příkaz uloží objekt konfigurace seznamu ACL do proměnné $Acl.

Druhý příkaz upraví pravidlo, které má ID 0. Příkaz změní pořadí a popis pravidla.

Poslední příkaz nastaví objekt konfigurace seznamu ACL pro tento virtuální počítač pomocí rutiny Set-AzureEndpoint . Příkaz také aktualizuje tento virtuální počítač.

Příklad 3: Odebrání pravidla z konfigurace seznamu 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

První příkaz uloží objekt konfigurace seznamu ACL do proměnné $Acl. To je stejné jako v předchozím příkladu.

Druhý příkaz odebere pravidlo, které má ID 0 z konfigurace seznamu ACL v $Acl.

Poslední příkaz nastaví objekt konfigurace seznamu ACL pro virtuální počítač a aktualizuje tento virtuální počítač. To je stejné jako v předchozím příkladu.

Parametry

-ACL

Určuje objekt konfigurace seznamu ACL, který tato rutina upraví.

Typ:NetworkAclObject
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Action

Určuje akci pravidla, které tato rutina přidá nebo upraví. Platné hodnoty jsou: Povolit a Odepřít.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AddRule

Označuje, že tato rutina přidá pravidlo do konfigurace seznamu ACL.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje popis pravidla, které tato rutina přidá nebo upraví.

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliasy:iv
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Order

Určuje pořadí zpracování pravidla, které tato rutina přidává nebo upravuje.

Typ:Int32
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RemoteSubnet

Určuje vzdálenou podsíť pravidla, které tato rutina přidá nebo upraví. Určuje adresu ve formátu technologie CIDR (Classless Interdomain Routing) (CIDR).

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RemoveRule

Označuje, že tato rutina odebere pravidlo z konfigurace seznamu ACL.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RuleId

Určuje ID pravidla, které tato rutina odebere nebo upraví pro konfiguraci seznamu ACL.

Typ:Int32
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SetRule

Označuje, že tato rutina upravuje pravidlo v konfiguraci seznamu ACL.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False