New-SCPortACLRule

ポート ACL 規則を作成します。

構文

New-SCPortACLRule
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-PortACL <PortACL>]
   -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>]

説明

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

例 1: ポート ACL 規則を作成する

PS C:\> $PortACL = New-SCPortACL -Name "RDP ACL" -Description "Acl on RDP access"
PS: C:\> New-SCPortACLRule -Name "AllowRDPAccess" -PortACL $PortACL -Description "Allow RDP Rule from a subnet" -Action Allow -Type Inbound -Priority 110 -Protocol Tcp -LocalPortRange 3389 -RemoteAddressPrefix 10.184.20.0/24

最初のコマンドは、ポート ACL を作成し、$PortACL変数に格納します。

2 番目のコマンドは、リモート サブネットからの RDP アクセスを許可するようにポート ACL ルールを作成します。

パラメーター

-Action

ポート ACL 規則アクションを指定します。 このパラメーターの有効値は、次のとおりです。

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

-Description

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

Type:String
Position:Named
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:0
Default value:None
Required:True
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

-PortACL

ポート ACL オブジェクトを指定します。

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

-Priority

優先順位を指定します。

Type:UInt16
Position:Named
Default value:None
Required:True
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:True
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:True
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