Share via

Set-AzurePublicIP

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

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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 エントリに使用する名前を指定します。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

Type:Int32
Position:2
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

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

出力

Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM