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 |