Set-AzureEndpoint

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

仮想マシンに割り当てられたエンドポイントを変更します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください。

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される PowerShell モジュールです。

構文

Set-AzureEndpoint
   [-Name] <String>
   [[-Protocol] <String>]
   [[-LocalPort] <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

Set-AzureEndpoint コマンドレットは、Azure 仮想マシンに割り当てられたエンドポイントを変更します。 負荷分散されていないエンドポイントに対する変更を指定できます。

例

例 1: ポートでリッスンするようにエンドポイントを変更する

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | Update-AzureVM

このコマンドは、Get-AzureVM コマンドレットを使用して、VirtualMachine01 という名前の仮想マシンの構成を取得します。 このコマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドレットは、ポート 443 でリッスンするように Web という名前のエンドポイントを変更します。 このコマンドは、変更を実装する Update-AzureVM コマンドレットに仮想マシン オブジェクトを渡します。

パラメーター

-ACL

このコマンドレットがエンドポイントに適用されるアクセス制御リスト (ACL) 構成オブジェクトを指定します。

型:NetworkAclObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DirectServerReturn

このコマンドレットでダイレクト サーバーの戻り値を有効にするかどうかを指定します。 有効にする$Trueを指定するか、無効にする$Falseを指定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IdleTimeoutInMinutes

エンドポイントの TCP アイドル タイムアウト期間を分単位で指定します。

型:Int32
配置:Named
規定値: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

-InternalLoadBalancerName

内部ロード バランサーの名前を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LoadBalancerDistribution

ロード バランサー分散アルゴリズムを指定します。 有効な値は次の通りです。

  • sourceIP。 2 つのタプル アフィニティ: ソース IP、宛先 IP
  • sourceIPProtocol。 3 つのタプル アフィニティ: ソース IP、宛先 IP、プロトコル
  • 何一つ。 5 つのタプル アフィニティ: 送信元 IP、送信元ポート、宛先 IP、宛先ポート、プロトコル

既定値は none です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalPort

このエンドポイントが使用するローカル、プライベート、ポートを指定します。 仮想マシン内のアプリケーションは、このポートでこのエンドポイントのサービス入力要求をリッスンします。

型:Int32
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

エンドポイントの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Protocol

エンドポイントのプロトコルを指定します。 有効な値は次の通りです。

  • tcp
  • udp
型:String
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublicPort

エンドポイントが使用するパブリック ポートを指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VirtualIPName

Azure がエンドポイントに関連付ける仮想 IP アドレスの名前を指定します。 サービスには複数の仮想 IP を含めることができます。 仮想 IP を作成するには、Add-AzureVirtualIP コマンドレットを使用します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VM

エンドポイントが属する仮想マシンを指定します。

型:IPersistentVM
Aliases:InputObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

Object