Set-AzureAclConfig
ACL 構成オブジェクトを変更します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「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 コマンドレットは、既存の Azure 仮想マシン構成からアクセス制御リスト (ACL) 構成オブジェクトを変更します。
例
例 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変数に格納します。
2 番目のコマンドは、$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最初のコマンドは、Get-AzureVM コマンドレットを使用して、ContosoService という名前のサービス内の VirtualMachine07 という名前の仮想マシンを取得します。 このコマンドは、パイプライン 演算子を使用して、そのオブジェクトを Get-AzureAclConfig コマンドレットに渡します。 このコマンドレットは、Web という名前のエンドポイントの ACL 構成を取得します。 このコマンドは、その ACL 構成オブジェクトを $Acl 変数に格納します。
2 番目のコマンドは、ID が 0 のルールを変更します。 このコマンドは、ルールの順序と説明を変更します。
最後のコマンドでは、Set-AzureEndpoint コマンドレットを使用して、その仮想マシンの ACL 構成オブジェクトを設定します。 このコマンドは、その仮想マシンも更新します。
例 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 構成オブジェクトを格納します。 これは前の例と同じです。
2 番目のコマンドは、$ACLの ACL 構成から ID 0 を持つ規則を削除します。
最後のコマンドは、仮想マシンの ACL 構成オブジェクトを設定し、その仮想マシンを更新します。 これは前の例と同じです。
パラメーター
-ACL
このコマンドレットが変更する ACL 構成オブジェクトを指定します。
| 型: | NetworkAclObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Action
このコマンドレットが追加または変更するルールのアクションを指定します。 有効な値は、許可と拒否です。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AddRule
このコマンドレットが ACL 構成に規則を追加することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
このコマンドレットが追加または変更するルールの説明を指定します。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
| 型: | ActionPreference |
| Aliases: | infa |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
| 型: | String |
| Aliases: | iv |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Order
このコマンドレットが追加または変更するルールの処理順序を指定します。
| 型: | Int32 |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoteSubnet
このコマンドレットが追加または変更するルールのリモート サブネットを指定します。 クラスレス ドメイン間ルーティング (CIDR) 形式のアドレスを指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveRule
このコマンドレットが ACL 構成から規則を削除することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RuleId
このコマンドレットが ACL 構成のために削除または変更する規則の ID を指定します。
| 型: | Int32 |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SetRule
このコマンドレットが ACL 構成の規則を変更することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |