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.

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

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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Action

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

Typ:String
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-AddRule

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Typ:String
Position:3
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliases:iv
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Order

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

Typ:Int32
Position:2
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRule

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleId

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

Typ:Int32
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-SetRule

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False