New-AzCustomIpPrefix
Tworzy zasób CustomIpPrefix
Składnia
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>]
Opis
Polecenie cmdlet New-AzCustomIpPrefix tworzy zasób CustomIpPrefix.
Przykłady
Przykład 1
$myCustomIpPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/24" -Location westus2 -Zone 1,2,3 -AuthorizationMessage $authorizationMessage -SignedMessage $signedMessage
To polecenie rozpoczyna proces aprowizacji dla nowego strefowo nadmiarowego zasobu niestandardowego prefiksu IP IPv4 o nazwie $prefixName w grupie zasobów $rgName z ciDR 40.40.40.0/24 w regionie Zachodnie stany USA 2. Uwaga AuthorizationMessage jest ciągiem kontaktowym (zawierającym identyfikator subskrypcji, ciDR i datę wygaśnięcia autoryzacji źródła trasy), a wartość SignedMessage jest tym samym ciągiem podpisanym przez certyfikat X509 w trybie offline.
Przykład 2
$myV4ParentPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/24" -Location westus2 -IsParent -AuthorizationMessage $authorizationMessage -SignedMessage $signedMessage
To polecenie rozpoczyna proces inicjowania obsługi administracyjnej dla nowego zasobu niestandardowego prefiksu IP IPv4 o nazwie $prefixName w grupie zasobów $rgName z ciDR 40.40.40.0/24.
Przykład 3
$myV4ChildIpPrefix = New-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr "40.40.40.0/25" -Location westus2 -CustomIpPrefixParent $myV4ParentPrefix
To polecenie rozpoczyna proces aprowizacji dla nowego zasobu niestandardowego prefiksu IP IPv4 podrzędnego o nazwie $prefixName w grupie zasobów $rgName z ciDR 40.40.40.0/25. Jego prefiks nadrzędny to $myV 4ParentPrefix.
Parametry
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Asn
Kod ASN customIpPrefix.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-AuthorizationMessage
Komunikat autoryzacji na potrzeby walidacji sieci WAN.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Cidr
CiDR customIpPrefix.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-CustomIpPrefixParent
Nadrzędny element CustomIpPrefix zasobu.
Typ: | PSCustomIpPrefix |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ExpressRouteAdvertise
Używanie anonsowania usługi ExpressRoute.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Geo
Kod GEO customIpPrefix.
Typ: | String |
Dopuszczalne wartości: | AFRI, APAC, AQ, EURO, LATAM, ME, NAM, OCEANIA |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-IsParent
Oznacza, że zasób jest tworzony jako nadrzędny element CustomIpPrefix
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Location
Lokalizacja CustomIpPrefix.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa zasobu.
Typ: | String |
Aliasy: | ResourceName |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-SignedMessage
Podpisany komunikat na potrzeby weryfikacji sieci WAN.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Tag
Tabela skrótu reprezentująca tagi zasobów.
Typ: | Hashtable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Zone
Lista stref dostępności oznaczających adres IP przydzielony dla zasobu musi pochodzić.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
String[]