Add-AzureEndpoint
仮想マシンにエンドポイントを追加します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Add-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>] Add-AzureEndpoint
[-Name] <String>
[-Protocol] <String>
[-LocalPort] <Int32>
[-PublicPort <Int32>]
[-DirectServerReturn <Boolean>]
[-ACL <NetworkAclObject>]
-LBSetName <String>
[-NoProbe]
[-InternalLoadBalancerName <String>]
[-IdleTimeoutInMinutes <Int32>]
[-LoadBalancerDistribution <String>]
[-VirtualIPName <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Add-AzureEndpoint
[-Name] <String>
[-Protocol] <String>
[-LocalPort] <Int32>
[-PublicPort <Int32>]
[-DirectServerReturn <Boolean>]
[-ACL <NetworkAclObject>]
-LBSetName <String>
[-DefaultProbe]
[-InternalLoadBalancerName <String>]
[-IdleTimeoutInMinutes <Int32>]
[-LoadBalancerDistribution <String>]
[-VirtualIPName <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Add-AzureEndpoint
[-Name] <String>
[-Protocol] <String>
[-LocalPort] <Int32>
[-PublicPort <Int32>]
[-DirectServerReturn <Boolean>]
[-ACL <NetworkAclObject>]
-LBSetName <String>
-ProbePort <Int32>
-ProbeProtocol <String>
[-ProbePath <String>]
[-ProbeIntervalInSeconds <Int32>]
[-ProbeTimeoutInSeconds <Int32>]
[-InternalLoadBalancerName <String>]
[-IdleTimeoutInMinutes <Int32>]
[-LoadBalancerDistribution <String>]
[-VirtualIPName <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 説明
Add-AzureEndpoint コマンドレットは、エンドポイントを Azure 仮想マシン オブジェクトに追加します。
例
例 1: エンドポイントを追加する
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | Update-AzureVMこのコマンドは、 Get-AzureVM コマンドレットを使用して、VirtualMachine01 という名前の仮想マシンの構成を取得します。 このコマンドは、パイプライン演算子を使用して現在のコマンドレットに渡します。 このコマンドレットは、HttpIn という名前のエンドポイントを追加します。 エンドポイントにはパブリック ポート 80 とローカル ポート 8080 があります。 このコマンドは、変更を実装する Update-AzureVM コマンドレットに仮想マシン オブジェクトを渡します。
例 2: 負荷分散グループに属するエンドポイントを追加する
PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVMこのコマンドは、VirtualMachine07 という名前の仮想マシンの構成を取得します。 現在のコマンドレットは、HttpIn という名前のエンドポイントを追加します。 エンドポイントにはパブリック ポート 80 とローカル ポート 8080 があります。 エンドポイントは、WebFarm という名前の共有負荷分散グループに属しています。 "/" のパスを持つポート 80 の HTTP プローブは、エンドポイントの可用性を監視します。 このコマンドは変更を実装します。
例 3: 仮想 IP をエンドポイントに関連付ける
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVMこのコマンドは、VirtualMachine25 という名前の仮想マシンの構成を取得します。 現在のコマンドレットは、HttpIn という名前のエンドポイントを追加します。 エンドポイントにはパブリック ポート 80 とローカル ポート 8080 があります。 このコマンドは、仮想 IP をエンドポイントに関連付けます。 このコマンドは変更を実装します。
パラメーター
-ACL
エンドポイントのアクセス制御リスト (ACL) 構成オブジェクトを指定します。
| 型: | NetworkAclObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProbe
このコマンドレットが既定のプローブ設定を使用することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
-LBSetName
エンドポイントに設定されたロード バランサーの名前を指定します。
| 型: | String |
| Aliases: | LoadBalancedEndpointSetName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
エンドポイントの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NoProbe
このコマンドレットがプローブなし設定を使用することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProbeIntervalInSeconds
エンドポイントのプローブ ポーリング間隔を秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProbePath
HTTP プローブへの相対パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProbePort
エンドポイントが使用するポートを指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProbeProtocol
ポート プロトコルを指定します。 有効な値は次の通りです。
- tcp
- http
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProbeTimeoutInSeconds
プローブポーリングタイムアウト期間を秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Protocol
エンドポイントのプロトコルを指定します。 有効な値は次の通りです。
- tcp
- udp
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PublicPort
エンドポイントが使用するパブリック ポートを指定します。 値を指定しない場合、Azure は使用可能なポートを割り当てます。
| 型: | 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 |