Add-IPAllowListEntry

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange のエッジ トランスポート サーバーでのみ使用可能または有効になります。

エッジ トランスポート サーバーで接続フィルター エージェントが使用する IP 許可一覧に IP 許可一覧エントリを追加するには、Add-IPAllowListEntry コマンドレットを使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Add-IPAllowListEntry
   -IPAddress <IPAddress>
   [-Comment <String>]
   [-Confirm]
   [-ExpirationTime <DateTime>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
Add-IPAllowListEntry
   -IPRange <IPRange>
   [-Comment <String>]
   [-Confirm]
   [-ExpirationTime <DateTime>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

説明

エッジ トランスポート サーバーで、このコマンドレットを実行するには、ローカルの Administrators グループのメンバーである必要があります。

例

例 1

Add-IPAllowListEntry -IPAddress 192.168.0.100

この例は、IP アドレス 192.168.0.100 を許可された IP アドレスの一覧に追加します。

例 2

Add-IPAllowListEntry -IPRange 192.168.0.1/24 -ExpirationTime "1/3/2014 23:59"

この例では、許可される IP アドレスの一覧に IP アドレス範囲 192.168.0.1/24 を追加し、2014 年 1 月 3 日の 23:59 に IP 許可リスト エントリの有効期限を設定します。

パラメーター

-Comment

Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExpirationTime

ExpirationTime パラメーターは、作成している IP 許可一覧のエントリの有効期限が切れる日時を指定します。 時刻のみを指定し、日付を指定しない場合、現在の日が想定されます。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 mm/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IPAddress

IPAddress パラメーターは、IP 許可一覧に追加する単一の IP アドレスを指定します (例: 192.168.0.1)。

Type:IPAddress
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IPRange

IPRange パラメーターは、IP 許可一覧に追加する IP アドレスの範囲を指定します。 有効な値は次のとおりです。

  • IP アドレス範囲: 192.168.0.1-192.168.0.254。
  • クラスレス Inter-Domain ルーティング (CIDR) IP アドレス範囲: 192.168.0.1/24 など。
Type:IPRange
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • FQDN
  • 識別名 (DN)
  • Exchange の従来の DN

このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。

このパラメーターを使用して、他のエッジ トランスポート サーバーをリモートで構成することはできません。

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。