Set-SCPortACLRule

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

ポート ACL 規則を変更します。

構文

Set-SCPortACLRule
   [-VMMServer <ServerConnection>]
   [-PortACLRule] <PortACLRule>
   [-Name <String>]
   [[-Description] <String>]
   [-Type <PortACLRuleDirection>]
   [-Action <PortACLRuleAction>]
   [-LocalAddressPrefix <String>]
   [-LocalPortRange <String>]
   [-RemoteAddressPrefix <String>]
   [-RemotePortRange <String>]
   [-Protocol <PortACLRuleProtocol>]
   [-Priority <UInt16>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCPortACLRule コマンドレットは、Virtual Machine Manager (VMM) のポート アクセス制御リスト (ACL) 規則を変更します。

例

例 1: ポート ACL 規則の優先順位を変更する

PS C:\> $PortACLRule = Get-SCPortACLRule -Name "AllowRDPAccess"
PS: C:\> Set-SCPortACLRule -PortACLRule $PortACLRule -Priority 220"

最初のコマンドは、AllowRDPAccess という名前のポート ACL 規則を取得し、$PortACLRule変数に格納します。

2 番目のコマンドは、$PortACLRuleのルールの優先度を 220 に変更します。

例 2: ポート acl 規則のリモート アドレス範囲とプロトコルを変更する

PS C:\> $PortACLRule = Get-SCPortACLRule -Name "AllowRDPAccess"
PS: C:\> Set-SCPortACLRule -PortACLRule $portACLRule -RemoteAddressPrefix 172.185.21.0/24 -Protocol Udp

最初のコマンドは、AllowRDPAccess という名前のポート ACL 規則を取得し、$PortACLRule変数に格納します。

2 番目のコマンドは、$PortACLRuleの ACL 規則のプロトコルを UDP に変更し、リモート アドレス範囲を別のサブネットに設定します。

パラメーター

-Action

ポート ACL ルール アクション オブジェクトを指定します。

Type:PortACLRuleAction
Accepted values:Allow, Deny
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

ポート ACL 規則の説明を指定します。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalAddressPrefix

ローカル アドレス プレフィックスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalPortRange

ローカル ポート範囲を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

ポート ACL 規則の名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACLRule

変更するポート ACL 規則を指定します。

Type:PortACLRule
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Priority

優先度を指定します。

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

プロトコルを指定します。 このパラメーターの有効値は、次のとおりです。

  • Tcp
  • Udp
  • Any
Type:PortACLRuleProtocol
Accepted values:Tcp, Udp, Any
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoteAddressPrefix

リモート アドレス プレフィックスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemotePortRange

リモート ポート範囲を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

型を指定します。 このパラメーターの有効値は、次のとおりです。

  • 受信
  • 送信
Type:PortACLRuleDirection
Accepted values:Inbound, Outbound
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False