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

New-AzCustomIpPrefix

创建 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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Asn

customIpPrefix ASN 代码。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-AuthorizationMessage

WAN 验证的授权消息。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Cidr

CustomIpPrefix CIDR。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CustomIpPrefixParent

资源的父 CustomIpPrefix。

类型:PSCustomIpPrefix
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExpressRouteAdvertise

使用 expressRoute 播发。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Geo

customIpPrefix GEO 代码。

类型:String
接受的值:AFRI, APAC, AQ, EURO, LATAM, ME, NAM, OCEANIA
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-IsParent

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

CustomIpPrefix 位置。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

资源名称。

类型:String
别名:ResourceName
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceGroupName

资源组名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SignedMessage

用于 WAN 验证的签名消息。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Tag

表示资源标记的哈希表。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Zone

表示为资源分配的 IP 需要来自的可用性区域列表。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

String

String[]

Hashtable

PSCustomIpPrefix

输出

PSCustomIpPrefix