Udostępnij za pośrednictwem


Set-AzureAclConfig

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
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-AddRule

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

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Typ:String
Position:3
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Order

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

Typ:Int32
Position:2
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRule

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

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-RuleId

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

Typ:Int32
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-SetRule

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

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False