New-AzCustomIpPrefix

建立 CustomIpPrefix 資源

Syntax

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>]

Description

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 是連絡字串(包含訂用帳戶標識碼、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