New-AzPublicIpAddress
パブリック 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このコマンドは、新しいパブリック IP アドレス リソースを作成します。このリソースのパブリック IP アドレスを指$dnsPrefix.$location.cloudapp.azure.com DNS レコードが作成されます。 -AllocationMethod が 'Static' として指定されているため、パブリック IP アドレスはすぐにこのリソースに割り当てられます。 "動的" として指定されている場合、パブリック 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 アドレス リソースを作成します。 指定した IP が PublicIpPrefix 内にあり、指定された PublicIpPrefix が BYOIP PublicIpPrefix の場合、NRP はチェック。 指定されたパブリック 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: DoメインNameLabelScope を使用してパブリック IP アドレスを作成する
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $locationこのコマンドは、新しいパブリック IP アドレス リソースを作成します。 -DoメインNameLabelScope パラメーターを使用すると、Azure は、このリソースに割り当てられたパブリック IP アドレスの FQDN にハッシュ値を持つ DNS レコードを作成し、$hasedReusePolicyによって提案されたポリシーを使用します。
パラメーター
-AllocationMethod
パブリック IP アドレスを割り当てる方法を指定します。 このパラメーターに使用できる値は、Static または Dynamic です。
| Type: | String |
| Accepted values: | Dynamic, Static |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
バックグラウンドでコマンドレットを実行する
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DdosProtectionMode
パブリック IP アドレスに使用する DdosProtectionMode
| Type: | String |
| Accepted values: | VirtualNetworkInherited, Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DdosProtectionPlanId
パブリック IP アドレスにアタッチする DdosProtectionPlan ID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainNameLabel
パブリック IP アドレスの相対 DNS 名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DomainNameLabelScope
パブリック IP アドレスの DNS 名に HashedReusePolicy を指定します。
| Type: | Nullable<T>[PSDomainNameLabelScopeType] |
| Accepted values: | TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EdgeZone
拡張された場所の名前。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
アイドルタイムアウトを分単位で指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddress
BYOIP publicIpAddress を作成するときに IP アドレスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddressVersion
IP アドレスのバージョンを指定します。
| Type: | String |
| Accepted values: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpTag
IpTag リスト。
| Type: | PSPublicIpTag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
パブリック IP アドレスを作成するリージョンを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
このコマンドレットで作成するパブリック IP アドレスの名前を指定します。
| Type: | String |
| Aliases: | ResourceName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicIpPrefix
パブリック IP アドレスの割り当て元となる PSPublicIpPrefix を指定します。
| Type: | PSPublicIpPrefix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
パブリック IP アドレスを作成するリソース グループの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReverseFqdn
逆の完全修飾 doメイン 名 (FQDN) を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
パブリック IP SKU 名。
| Type: | String |
| Accepted values: | Basic, Standard |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tier
パブリック IP SKU レベル。
| Type: | String |
| Accepted values: | Regional, Global |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
リソースに割り当てられた IP を示す可用性ゾーンの一覧が必要です。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
入力
String[]
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示