Set-AzureAclConfig

  • リファレンス
モジュール:
Azure

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
  • Stop
  • [中断]
型: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