你当前正在访问 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[]
