你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzCustomIpPrefix

  • 参考
模块:
Az.Network

创建 CustomIpPrefix 资源

语法

New-AzCustomIpPrefix
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Cidr <String>
   [-Asn <String>]
   [-Geo <String>]
   [-SignedMessage <String>]
   [-AuthorizationMessage <String>]
   [-ExpressRouteAdvertise]
   [-CustomIpPrefixParent <PSCustomIpPrefix>]
   [-IsParent]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzCustomIpPrefix cmdlet 创建 CustomIpPrefix 资源。

示例

示例 1

$myCustomIpPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/24" -Location westus2 -Zone 1,2,3 -AuthorizationMessage $authorizationMessage -SignedMessage $signedMessage

此命令启动新的区域冗余 IPv4 自定义 IP 前缀资源的预配过程，该资源的名称为$prefixName资源组$rgName，CIDR 为 40.40.40.0/24（位于美国西部 2 区域）。 请注意，AuthorizationMessage 是一个联系字符串（包含订阅 ID、CIDR 和路由源授权到期日期），SignedMessage 与 X509 证书脱机签名的字符串相同。

示例 2

$myV4ParentPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/24" -Location westus2 -IsParent -AuthorizationMessage $authorizationMessage -SignedMessage $signedMessage

此命令启动新父 IPv4 自定义 IP 前缀资源的预配过程，该资源在资源组中具有名称$prefixName$rgName CIDR 为 40.40.40.0/24。

示例 3

$myV4ChildIpPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/25" -Location westus2 -CustomIpPrefixParent $myV4ParentPrefix

此命令启动新的子 IPv4 自定义 IP 前缀资源的预配过程，该资源的名称$prefixName资源组中$rgName CIDR 为 40.40.40.0/25。 其父前缀为 $myV 4ParentPrefix。

参数

-AsJob

在后台运行 cmdlet

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

-Asn

customIpPrefix ASN 代码。

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

-AuthorizationMessage

WAN 验证的授权消息。

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

-Cidr

CustomIpPrefix CIDR。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomIpPrefixParent

资源的父 CustomIpPrefix。

Type:PSCustomIpPrefix
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

-ExpressRouteAdvertise

使用 expressRoute 播发。

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

-Geo

customIpPrefix GEO 代码。

Type:String
Accepted values:AFRI, APAC, AQ, EURO, LATAM, ME, NAM, OCEANIA
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IsParent

表示正在将资源创建为父 CustomIpPrefix

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

-Location

CustomIpPrefix 位置。

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

-Name

资源名称。

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

-ResourceGroupName

资源组名称。

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

-SignedMessage

用于 WAN 验证的签名消息。

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

-Tag

表示资源标记的哈希表。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
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

String[]

Hashtable

PSCustomIpPrefix

输出

PSCustomIpPrefix