Set-AzureAclConfig
ACL 構成オブジェクトを変更します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 構成オブジェクトを指定します。
Type: | NetworkAclObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Action
このコマンドレットが追加または変更するルールのアクションを指定します。 有効な値は、許可と拒否です。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddRule
このコマンドレットが ACL 構成に規則を追加することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
このコマンドレットが追加または変更するルールの説明を指定します。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Order
このコマンドレットが追加または変更するルールの処理順序を指定します。
Type: | Int32 |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoteSubnet
このコマンドレットが追加または変更するルールのリモート サブネットを指定します。 クラスレス ドメイン間ルーティング (CIDR) 形式のアドレスを指定します。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveRule
このコマンドレットが ACL 構成から規則を削除することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleId
このコマンドレットが ACL 構成のために削除または変更する規則の ID を指定します。
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SetRule
このコマンドレットが ACL 構成の規則を変更することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |