Set-AzureEndpoint
仮想マシンに割り当てられたエンドポイントを変更します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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) 構成オブジェクトを指定します。
Type: | NetworkAclObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DirectServerReturn
このコマンドレットでダイレクト サーバーの戻り値を有効にするかどうかを指定します。 有効にする$Trueを指定するか、無効にする$Falseを指定します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdleTimeoutInMinutes
エンドポイントの TCP アイドル タイムアウト期間を分単位で指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InternalLoadBalancerName
内部ロード バランサーの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LoadBalancerDistribution
ロード バランサー分散アルゴリズムを指定します。 有効な値は次のとおりです。
- sourceIP。 2 つのタプル アフィニティ: ソース IP、宛先 IP
- sourceIPProtocol。 3 つのタプル アフィニティ: ソース IP、宛先 IP、プロトコル
- なし。 5 つのタプル アフィニティ: 送信元 IP、送信元ポート、宛先 IP、宛先ポート、プロトコル
既定値は none です。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalPort
このエンドポイントが使用するローカル、プライベート、ポートを指定します。 仮想マシン内のアプリケーションは、このポートでこのエンドポイントのサービス入力要求をリッスンします。
Type: | Int32 |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
エンドポイントの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
エンドポイントのプロトコルを指定します。 有効な値は次のとおりです。
- tcp
- udp
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicPort
エンドポイントが使用するパブリック ポートを指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualIPName
Azure がエンドポイントに関連付ける仮想 IP アドレスの名前を指定します。 サービスには複数の仮想 IP を含めることができます。 仮想 IP を作成するには、Add-AzureVirtualIP コマンドレットを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
エンドポイントが属する仮想マシンを指定します。
Type: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |