Udostępnij za pośrednictwem

Set-AzureAclConfig

  • Odwołanie
Moduł:
Azure

Modyfikuje obiekt konfiguracji listy ACL.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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>]

Opis

Polecenie cmdlet Set-AzureAclConfig modyfikuje obiekt konfiguracji listy kontroli dostępu (ACL) z istniejącej konfiguracji maszyny wirtualnej platformy Azure.

Przykłady

Przykład 1. Dodawanie reguły do nowej konfiguracji listy 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"

Pierwsze polecenie tworzy konfigurację listy ACL, a następnie zapisuje ją w zmiennej $Acl.

Drugie polecenie dodaje nową regułę do konfiguracji przechowywanej w $Acl. Polecenie określa akcję, podsieć, kolejność i opis reguły.

Przykład 2. Modyfikowanie reguły w konfiguracji listy 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

Pierwsze polecenie pobiera maszynę wirtualną o nazwie VirtualMachine07 w usłudze o nazwie ContosoService przy użyciu polecenia cmdlet Get-AzureVM . Polecenie przekazuje ten obiekt do polecenia cmdlet Get-AzureAclConfig przy użyciu operatora potoku. To polecenie cmdlet pobiera konfigurację listy ACL dla punktu końcowego o nazwie Web. Polecenie przechowuje obiekt konfiguracji listy ACL w zmiennej $Acl.

Drugie polecenie modyfikuje regułę o identyfikatorze 0. Polecenie zmienia kolejność i opis reguły.

Ostatnie polecenie ustawia obiekt konfiguracji listy ACL dla tej maszyny wirtualnej przy użyciu polecenia cmdlet Set-AzureEndpoint . Polecenie aktualizuje również maszynę wirtualną.

Przykład 3. Usuwanie reguły z konfiguracji listy 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

Pierwsze polecenie przechowuje obiekt konfiguracji listy ACL w zmiennej $Acl. Jest to takie samo, jak w poprzednim przykładzie.

Drugie polecenie usuwa regułę o identyfikatorze 0 z konfiguracji listy ACL w $Acl.

Ostatnie polecenie ustawia obiekt konfiguracji listy ACL dla maszyny wirtualnej i aktualizuje maszynę wirtualną. Jest to takie samo, jak w poprzednim przykładzie.

Parametry

-ACL

Określa obiekt konfiguracji listy ACL, który modyfikuje to polecenie cmdlet.

Typ:NetworkAclObject
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Action

Określa akcję dla reguły, którą to polecenie cmdlet dodaje lub modyfikuje. Prawidłowe wartości to: Zezwól i Odmów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AddRule

Wskazuje, że to polecenie cmdlet dodaje regułę do konfiguracji listy ACL.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa opis reguły, którą to polecenie cmdlet dodaje lub modyfikuje.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliasy:infa
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliasy:iv
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Order

Określa kolejność przetwarzania dla reguły, którą to polecenie cmdlet dodaje lub modyfikuje.

Typ:Int32
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RemoteSubnet

Określa podsieć zdalną dla reguły, którą to polecenie cmdlet dodaje lub modyfikuje. Określa adres w formacie CIDR (Classless Interdomain Routing).

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RemoveRule

Wskazuje, że to polecenie cmdlet usuwa regułę z konfiguracji listy ACL.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RuleId

Określa identyfikator reguły, którą to polecenie cmdlet usuwa lub modyfikuje dla konfiguracji listy ACL.

Typ:Int32
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SetRule

Wskazuje, że to polecenie cmdlet modyfikuje regułę w konfiguracji listy ACL.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False