次の方法で共有

New-AzPublicIpAddress

モジュール:
Az.Network Module

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

構文

Default (既定) 

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 レコードが作成されます。 パブリック IP アドレスは、-AllocationMethod が 'Static' として指定されているため、すぐにこのリソースに割り当てられます。 "動的" として指定されている場合、パブリック 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

このコマンドは、新しいパブリック IP アドレス リソースを作成します。このリソースのパブリック IP アドレスを指$dnsPrefix.$___location.cloudapp.azure.com DNS レコードが作成されます。 パブリック IP アドレスは、-AllocationMethod が 'Static' として指定されているため、すぐにこのリソースに割り当てられます。 "動的" として指定されている場合、パブリック IP アドレスは、関連付けられているリソース (VM やロード バランサーなど) を開始 (または作成) したときにのみ割り当てられます。 Iptag は、リソースに関連付けられているタグを特定するために使用されます。 iptag は、New-AzPublicIpTag を使用して指定し、-IpTags を介して入力として渡すことができます。

例 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
規定値:None
指定可能な値:Dynamic, Static
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-AsJob

バックグラウンドでコマンドレットを実行する

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DdosProtectionMode

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

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:VirtualNetworkInherited, Enabled, Disabled
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DdosProtectionPlanId

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainNameLabel

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DomainNameLabelScope

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

パラメーターのプロパティ

型:

Nullable<T>[PSDomainNameLabelScopeType]

規定値:None
指定可能な値:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-EdgeZone

拡張された場所の名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IdleTimeoutInMinutes

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

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IpAddress

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IpAddressVersion

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

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:IPv4, IPv6
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IpTag

IpTag リスト。

パラメーターのプロパティ

型:

PSPublicIpTag[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Location

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

このコマンドレットで作成するパブリック IP アドレスの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ResourceName

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PublicIpPrefix

パブリック IP アドレスの割り当て元となる PSPublicIpPrefix を指定します。

パラメーターのプロパティ

型:PSPublicIpPrefix
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ResourceGroupName

パブリック IP アドレスを作成するリソース グループの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ReverseFqdn

逆完全修飾ドメイン名 (FQDN) を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Sku

パブリック IP SKU 名。

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:Basic, Standard, StandardV2
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Tag

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Tier

パブリック IP SKU レベル。

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:Regional, Global
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Zone

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

出力

PSPublicIpAddress