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 |