New-AzPublicIpAddress
Tworzy publiczny adres IP.
Składnia
New-AzPublicIpAddress
[-Name <String>]
-ResourceGroupName <String>
-Location <String>
[-EdgeZone <String>]
[-Sku <String>]
[-Tier <String>]
-AllocationMethod <String>
[-IpAddressVersion <String>]
[-DomainNameLabel <String>]
[-DomainNameLabelScope <PSDomainNameLabelScopeType>]
[-IpTag <PSPublicIpTag[]>]
[-PublicIpPrefix <PSPublicIpPrefix>]
[-DdosProtectionMode <String>]
[-DdosProtectionPlanId <String>]
[-ReverseFqdn <String>]
[-IdleTimeoutInMinutes <Int32>]
[-Zone <String[]>]
[-IpAddress <String>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet New-AzPublicIpAddress tworzy publiczny adres IP.
Przykłady
Przykład 1. Tworzenie nowego publicznego adresu IP
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu, ponieważ parametr -AllocationMethod jest określony jako "Statyczny". Jeśli zostanie określony jako "Dynamiczny", publiczny adres IP zostanie przydzielony tylko po uruchomieniu (lub utworzeniu) skojarzonego zasobu (na przykład maszyny wirtualnej lub modułu równoważenia obciążenia).
Przykład 2. Tworzenie publicznego adresu IP z odwrotną nazwą FQDN
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn
To polecenie tworzy nowy zasób publicznego adresu IP. Za pomocą parametru -ReverseFqdn platforma Azure tworzy rekord PTR DNS (wyszukiwanie wsteczne) dla publicznego adresu IP przydzielonego do tego zasobu, wskazując $customFqdn określony w poleceniu . Jako warunek wstępny, $customFqdn (powiedzmy, webapp.contoso.com) powinien mieć rekord CNAME DNS (wyszukiwanie do przodu) wskazujący na $dnsPrefix.$location.cloudapp.azure.com.
Przykład 3. Tworzenie nowego publicznego adresu IP przy użyciu elementu IpTag
$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag
To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu, ponieważ parametr -AllocationMethod jest określony jako "Statyczny". Jeśli zostanie określony jako "Dynamiczny", publiczny adres IP zostanie przydzielony tylko po uruchomieniu (lub utworzeniu) skojarzonego zasobu (na przykład maszyny wirtualnej lub modułu równoważenia obciążenia). Element Iptag służy do określania tagów skojarzonych z zasobem. Adres IPtag można określić przy użyciu polecenia New-AzPublicIpTag i przekazać go jako dane wejściowe za pośrednictwem -IpTags.
Przykład 4. Tworzenie nowego publicznego adresu IP na podstawie prefiksu
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -PublicIpPrefix $publicIpPrefix -Sku Standard
To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu z określonego publicznego prefiksuIpPrefix. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod.
Przykład 5. Tworzenie określonego publicznego adresu IP na podstawie prefiksu BYOIP
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard
To polecenie tworzy nowy zasób publicznego adresu IP z określonym adresem IP. NrP sprawdzi, czy dany adres IP znajduje się wewnątrz prefiksu PublicIpPrefix i czy dany prefiks PublicIpPrefix to BYOIP PublicIpPrefix. dany publiczny adres IP jest natychmiast przydzielany do tego zasobu z określonego publicznego prefiksuIpPrefix. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod i publicIpPrefix byOIP.
Przykład 6. Tworzenie nowego globalnego publicznego adresu IP
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global
To polecenie tworzy nowy globalny zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Globalny publiczny adres IP jest natychmiast przydzielany do tego zasobu. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod.
Przykład 7. Tworzenie publicznego adresu IP przy użyciu elementu DomainNameLabelScope
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location
To polecenie tworzy nowy zasób publicznego adresu IP. Za pomocą parametru -DomainNameLabelScope platforma Azure tworzy rekord DNS z wartością skrótu w nazwie FQDN dla publicznego adresu IP przydzielonego do tego zasobu przy użyciu zasad sugerowanych przez $hasedReusePolicy.
Parametry
-AllocationMethod
Określa metodę przydzielania publicznego adresu IP. Dopuszczalne wartości tego parametru to: Statyczne lub Dynamiczne.
Typ: | String |
akceptowane wartości: | Dynamic, Static |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DdosProtectionMode
DdosProtectionMode do użycia dla publicznego adresu IP
Typ: | String |
akceptowane wartości: | VirtualNetworkInherited, Enabled, Disabled |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DdosProtectionPlanId
Identyfikator DdosProtectionPlan do dołączenia do publicznego adresu IP
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainNameLabel
Określa względną nazwę DNS dla publicznego adresu IP.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DomainNameLabelScope
Określa wartość HashedReusePolicy dla nazwy DNS publicznego adresu IP.
Typ: | Nullable<T>[PSDomainNameLabelScopeType] |
akceptowane wartości: | TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EdgeZone
Nazwa lokalizacji rozszerzonej.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Określa limit czasu bezczynności w minutach.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IpAddress
Określa adres IP podczas tworzenia publicznego adresuIP BYOIPAddress.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IpAddressVersion
Określa wersję adresu IP.
Typ: | String |
akceptowane wartości: | IPv4, IPv6 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IpTag
Lista adresów IPTag.
Typ: | PSPublicIpTag[] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Określa region, w którym ma zostać utworzony publiczny adres IP.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Określa nazwę publicznego adresu IP tworzonego przez to polecenie cmdlet.
Typ: | String |
Aliases: | ResourceName |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicIpPrefix
Określa psPublicIpPrefix, z którego ma być przydzielany publiczny adres IP.
Typ: | PSPublicIpPrefix |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Określa nazwę grupy zasobów, w której ma zostać utworzony publiczny adres IP.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReverseFqdn
Określa odwrotnie w pełni kwalifikowaną nazwę domeny (FQDN).
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Sku
Nazwa jednostki SKU publicznego adresu IP.
Typ: | String |
akceptowane wartości: | Basic, Standard |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}
Typ: | Hashtable |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tier
Warstwa jednostki SKU publicznego adresu IP.
Typ: | String |
akceptowane wartości: | Regional, Global |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Lista stref dostępności oznaczających adres IP przydzielony dla zasobu musi pochodzić.
Typ: | String[] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
String[]
Dane wyjściowe
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla