Set-AzurePublicIP

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

パブリック IP を Azure 仮想マシンに追加します。

Note

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

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

構文

Set-AzurePublicIP
   [-PublicIPName] <String>
   [[-IdleTimeoutInMinutes] <Int32>]
   [[-DomainNameLabel] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

Set-AzurePublicIP コマンドレットは、パブリック IP を Azure 仮想マシンに追加します。 既存の仮想マシンに対してこのコマンドレットを実行する場合は、変更を実装するように仮想マシンを更新します。 ドメイン名ラベルを指定して、パブリック IP に対応する DNS エントリを作成できます。

例

例 1: 既存の仮想マシンにパブリック IP を追加する

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" | Update-AzureVM

このコマンドは、Get-AzureVM コマンドレットを使用して、FTPInAzure という名前のサービスで FTPInstance という名前の仮想マシンを取得します。 このコマンドは、パイプライン 演算子を使用して、その仮想マシンを現在のコマンドレットに渡します。 現在のコマンドレットは、パブリック IP 名 ftpip を追加します。 このコマンドは、変更を実装する Update-AzureVM コマンドレットに仮想マシンを渡します。

例 2: 新しい仮想マシンにパブリック IP を追加する

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

このコマンドは、New-AzureVMConfig コマンドレットを使用して仮想マシン構成オブジェクトを作成します。 このコマンドは、追加の構成を 提供する Add-AzureProvisioningConfig コマンドレットにそのオブジェクトを渡します。 現在のコマンドレットは、パブリック IP 名 ftpip を追加します。 このコマンドは、仮想マシンを 作成する New-AzureVM コマンドレットに構成を渡します。

例 3: 既存の仮想マシンにパブリック IP とラベルを追加する

PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | Update-AzureVM

このコマンドは、Get-AzureVM コマンドレットを使用して、FTPInAzure という名前のサービスで FTPInstance という名前の仮想マシンを取得します。 このコマンドは、パイプライン 演算子を使用して、その仮想マシンを現在のコマンドレットに渡します。 現在のコマンドレットは、パブリック IP 名 ftpip とラベル ipname を追加します。 このコマンドは、変更を実装する仮想マシンを更新します。

例 4: パブリック IP とラベルを新しい仮想マシンに追加する

PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName $images[50].ImageName | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"

このコマンドは、仮想マシン構成オブジェクトを作成し、そのオブジェクトを Add-AzureProvisioningConfig に渡します。これにより、追加の構成が提供されます。 現在のコマンドレットは、パブリック IP 名 ftpip とラベル ipname を追加します。 このコマンドを実行すると、仮想マシンが作成されます。

パラメーター

-DomainNameLabel

パブリック IP アドレスに対応する DNS エントリに使用する名前を指定します。

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

-IdleTimeoutInMinutes

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

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

-Profile

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

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

-PublicIPName

パブリック IP 名を指定します。

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

-VM

このコマンドレットがパブリック IP を追加する仮想マシンを指定します。

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

出力

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM