Поделиться через


Set-AzureAclConfig

Изменяет объект конфигурации ACL.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

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

Описание

Командлет Set-AzureAclConfig изменяет объект конфигурации списка управления доступом (ACL) из существующей конфигурации виртуальной машины Azure.

Примеры

Пример 1. Добавление правила в новую конфигурацию 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"

Первая команда создает конфигурацию ACL, а затем сохраняет ее в переменной $Acl.

Вторая команда добавляет новое правило в конфигурацию, хранящуюся в $Acl. Команда задает действие, подсеть, порядок и описание правила.

Пример 2. Изменение правила в конфигурации 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

Первая команда получает виртуальную машину с именем VirtualMachine07 в службе с именем ContosoService с помощью командлета Get-AzureVM . Команда передает этот объект командлету Get-AzureAclConfig с помощью оператора конвейера. Этот командлет получает конфигурацию ACL для конечной точки с именем Web. Команда сохраняет объект конфигурации ACL в переменной $Acl.

Вторая команда изменяет правило с идентификатором 0. Команда изменяет порядок и описание правила.

Последняя команда задает объект конфигурации ACL для этой виртуальной машины с помощью командлета Set-AzureEndpoint . Эта команда также обновляет виртуальную машину.

Пример 3. Удаление правила из конфигурации 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

Первая команда сохраняет объект конфигурации ACL в переменной $Acl. Это то же самое, что и предыдущий пример.

Вторая команда удаляет правило с идентификатором 0 из конфигурации ACL в $Acl.

Последняя команда задает объект конфигурации ACL для виртуальной машины и обновляет ее. Это то же самое, что и предыдущий пример.

Параметры

-ACL

Указывает объект конфигурации ACL, который изменяет этот командлет.

Тип:NetworkAclObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Action

Указывает действие для правила, которое добавляет или изменяет этот командлет. Допустимые значения: разрешение и запрет.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddRule

Указывает, что этот командлет добавляет правило в конфигурацию ACL.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Указывает описание правила, которое добавляет или изменяет этот командлет.

Тип:String
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Допустимые значения для этого параметра:

  • Продолжить
  • Пропустить
  • Спрашивать
  • SilentlyContinue
  • Остановить
  • Приостановить
Тип:ActionPreference
Aliases:infa
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InformationVariable

Указывает переменную сведений.

Тип:String
Aliases:iv
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Order

Указывает порядок обработки правила, добавляемого или изменяемого этим командлетом.

Тип:Int32
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoteSubnet

Указывает удаленную подсеть для правила, которое этот командлет добавляет или изменяет. Задает адрес в формате CIDR (CIDR).

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveRule

Указывает, что этот командлет удаляет правило из конфигурации ACL.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RuleId

Указывает идентификатор правила, которое этот командлет удаляет или изменяет конфигурацию ACL.

Тип:Int32
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SetRule

Указывает, что этот командлет изменяет правило в конфигурации ACL.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False