New-AzureRmPublicIpAddress
パブリック IP アドレスを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmPublicIpAddress
[-Name <String>]
-ResourceGroupName <String>
[-Location <String>]
[-Sku <String>]
-AllocationMethod <String>
[-IpAddressVersion <String>]
[-DomainNameLabel <String>]
[-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
[-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
[-ReverseFqdn <String>]
[-IdleTimeoutInMinutes <Int32>]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzureRmPublicIpAddress コマンドレットは、パブリック IP アドレスを作成します。
例
1: 新しいパブリック IP アドレスを作成する
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
このコマンドは、新しいパブリック IP アドレス リソースを作成します。このリソースのパブリック IP アドレスを指$dnsPrefix.$location.cloudapp.azure.com DNS レコードが作成されます。 -AllocationMethod が 'Static' として指定されているため、パブリック IP アドレスはすぐにこのリソースに割り当てられます。 "動的" として指定されている場合、パブリック IP アドレスは、関連付けられているリソース (VM やロード バランサーなど) を開始 (または作成) したときにのみ割り当てられます。
2: 逆 FQDN を使用してパブリック IP アドレスを作成する
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn
このコマンドは、新しいパブリック IP アドレス リソースを作成します。 -ReverseFqdn パラメーターを使用すると、Azure は、このリソースに割り当てられたパブリック IP アドレスの DNS PTR レコード (逆引き参照) を作成し、コマンドで指定された$customFqdnを指します。 前提条件として、$customFqdn (webapp.contoso.com など) には、$dnsPrefix.$location.cloudapp.azure.comを指す DNS CNAME レコード (前方参照) が必要です。
3: IpTag を使用して新しいパブリック IP アドレスを作成する
$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag
このコマンドは、新しいパブリック IP アドレス リソースを作成します。このリソースのパブリック IP アドレスを指$dnsPrefix.$location.cloudapp.azure.com DNS レコードが作成されます。 -AllocationMethod が 'Static' として指定されているため、パブリック IP アドレスはすぐにこのリソースに割り当てられます。 "動的" として指定されている場合、パブリック IP アドレスは、関連付けられているリソース (VM やロード バランサーなど) を開始 (または作成) したときにのみ割り当てられます。 Iptag は、リソースに関連付けられているタグを特定するために使用されます。 Iptag は New-AzureRmPublicIpTag を使用して指定し、-IpTags を介して入力として渡すことができます。
4: プレフィックスから新しいパブリック IP アドレスを作成する
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
-PublicIpPrefix publicIpPrefix -Sku Standard
このコマンドは、新しいパブリック IP アドレス リソースを作成します。 このリソースのパブリック IP アドレスを指$dnsPrefix.$location.cloudapp.azure.com DNS レコードが作成されます。 パブリック IP アドレスは、指定された publicIpPrefix からすぐにこのリソースに割り当てられます。 このオプションは、'Standard' SKU と 'Static' AllocationMethod でのみサポートされています。
パラメーター
-AllocationMethod
パブリック IP アドレスを割り当てる方法を指定します。 このパラメーターに使用できる値は、Static または Dynamic です。
型: | String |
指定可能な値: | Dynamic, Static |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-AsJob
バックグラウンドでコマンドレットを実行する
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DomainNameLabel
パブリック IP アドレスの相対 DNS 名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IdleTimeoutInMinutes
アイドルタイムアウトを分単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-IpAddressVersion
IP アドレスのバージョンを指定します。
型: | String |
指定可能な値: | IPv4, IPv6 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-IpTag
IpTag リスト。
型: | List<T>[PSPublicIpTag] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Location
パブリック IP アドレスを作成するリージョンを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットで作成するパブリック IP アドレスの名前を指定します。
型: | String |
Aliases: | ResourceName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PublicIpPrefix
パブリック IP アドレスの割り当て元となる PSPublicIpPrefix を指定します。
型: | PSPublicIpPrefix |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
パブリック IP アドレスを作成するリソース グループの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ReverseFqdn
逆完全修飾ドメイン名 (FQDN) を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Sku
パブリック IP SKU 名。
型: | String |
指定可能な値: | Basic, Standard |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Tag
ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}
型: | Hashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Zone
リソースに割り当てられた IP を示す可用性ゾーンの一覧が必要です。
型: | List<T>[String] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]