New-AzPublicIpAddress

リファレンス

モジュール:: Az.Network

パブリック IP アドレスを作成します。

構文

New-AzPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   [-Sku <String>]
   [-Tier <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
   [-IpTag <PSPublicIpTag[]>]
   [-PublicIpPrefix <PSPublicIpPrefix>]
   [-DdosProtectionMode <String>]
   [-DdosProtectionPlanId <String>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <String[]>]
   [-IpAddress <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzPublicIpAddress コマンドレットは、パブリック IP アドレスを作成します。

例

例 1: 新しいパブリック IP アドレスを作成する

$publicIp = New-AzPublicIpAddress -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-AzPublicIpAddress -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-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

例 4: プレフィックスから新しいパブリック IP アドレスを作成する

$publicIp = New-AzPublicIpAddress -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 でのみサポートされています。

例 5: BYOIP プレフィックスから特定のパブリック IP アドレスを作成する

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

このコマンドは、特定の IP を持つ新しいパブリック IP アドレスリソースを作成します。 NRP は、指定された IP が PublicIpPrefix 内にあるかどうか、および指定された PublicIpPrefix が BYOIP PublicIpPrefix であるかどうかを確認します。指定されたパブリック IP アドレスは、指定された publicIpPrefix からすぐにこのリソースに割り当てられます。このオプションは、'Standard' SKU と 'Static' AllocationMethod と BYOIP PublicIpPrefix でのみサポートされます。

例 6: 新しいグローバルパブリック IP アドレスを作成する

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

このコマンドを実行すると、新しいグローバルパブリック IP アドレスリソースが作成されます。このリソースのパブリック IP アドレスを指$dnsPrefix.$location.cloudapp.azure.com DNS レコードが作成されます。グローバルパブリック IP アドレスは、このリソースにすぐに割り当てられます。このオプションは、'Standard' SKU と 'Static' AllocationMethod でのみサポートされています。

例 7: DomainNameLabelScope を使用してパブリック IP アドレスを作成する

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

このコマンドは、新しいパブリック IP アドレスリソースを作成します。 -DomainNameLabelScope パラメーターを使用すると、Azure は、このリソースに割り当てられたパブリック IP アドレスの FQDN にハッシュ値を持つ DNS レコードを作成し、$hasedReusePolicyによって提案されたポリシーを使用します。

パラメーター

-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

-DdosProtectionMode

パブリック IP アドレスに使用する DdosProtectionMode

型:	String
指定可能な値:	VirtualNetworkInherited, Enabled, Disabled
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DdosProtectionPlanId

パブリック IP アドレスにアタッチする DdosProtectionPlan ID

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

-DomainNameLabel

パブリック IP アドレスの相対 DNS 名を指定します。

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

-DomainNameLabelScope

パブリック IP アドレスの DNS 名に HashedReusePolicy を指定します。

型:	Nullable<T>[PSDomainNameLabelScopeType]
指定可能な値:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-EdgeZone

拡張された場所の名前。

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-IdleTimeoutInMinutes

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

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

-IpAddress

BYOIP publicIpAddress を作成するときに IP アドレスを指定します。

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

-IpAddressVersion

IP アドレスのバージョンを指定します。

型:	String
指定可能な値:	IPv4, IPv6
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-IpTag

IpTag リスト。

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

-Location

パブリック IP アドレスを作成するリージョンを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	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

-Tier

パブリック IP SKU レベル。

型:	String
指定可能な値:	Regional, Global
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

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

-Zone

リソースに割り当てられた IP を示す可用性ゾーンの一覧が必要です。

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

入力

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

出力

PSPublicIpAddress

次の方法で共有

New-AzPublicIpAddress

構文

説明

例

例 1: 新しいパブリック IP アドレスを作成する

例 2: 逆 FQDN を使用してパブリック IP アドレスを作成する

例 3: IpTag を使用して新しいパブリック IP アドレスを作成する

例 4: プレフィックスから新しいパブリック IP アドレスを作成する

例 5: BYOIP プレフィックスから特定のパブリック IP アドレスを作成する

例 6: 新しいグローバルパブリック IP アドレスを作成する

例 7: DomainNameLabelScope を使用してパブリック IP アドレスを作成する

パラメーター

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

入力

出力

その他のリソース

次の方法で共有

New-AzPublicIpAddress

構文

説明

例

例 1: 新しいパブリック IP アドレスを作成する

例 2: 逆 FQDN を使用してパブリック IP アドレスを作成する

例 3: IpTag を使用して新しいパブリック IP アドレスを作成する

例 4: プレフィックスから新しいパブリック IP アドレスを作成する

例 5: BYOIP プレフィックスから特定のパブリック IP アドレスを作成する

例 6: 新しいグローバル パブリック IP アドレスを作成する

例 7: DomainNameLabelScope を使用してパブリック IP アドレスを作成する

パラメーター

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

入力

出力

関連リンク

その他のリソース

例 6: 新しいグローバルパブリック IP アドレスを作成する