Udostępnij przez


Set-AzPublicIpAddress

Aktualizuje publiczny adres IP.

Składnia

Default (domyślnie)

Set-AzPublicIpAddress
    -PublicIpAddress <PSPublicIpAddress>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzPublicIpAddress aktualizuje publiczny adres IP.

Przykłady

Przykład 1: Zmiana metody alokacji publicznego adresu IP

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.PublicIpAllocationMethod = "Static"

Set-AzPublicIpAddress -PublicIpAddress $publicIp

Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

Pierwsze polecenie pobiera zasób publicznego adresu IP o nazwie $publicIPName w $rgName grupy zasobów. Drugie polecenie ustawia metodę alokacji obiektu publicznego adresu IP na "Statyczny". Set-AzPublicIPAddress polecenie aktualizuje zasób publicznego adresu IP przy użyciu zaktualizowanego obiektu i modyfikuje metodę alokacji na "Statyczny". Publiczny adres IP jest przydzielany natychmiast.

Przykład 2. Dodawanie etykiety domeny DNS publicznego adresu IP

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings = @{"DomainNameLabel" = "newdnsprefix"}

Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

Pierwsze polecenie pobiera zasób publicznego adresu IP o nazwie $publicIPName w $rgName grupy zasobów. Drugie polecenie ustawia właściwość DomainNameLabel na wymagany prefiks DNS. Set-AzPublicIPAddress polecenie aktualizuje zasób publicznego adresu IP za pomocą zaktualizowanego obiektu. DomainNameLabel i Fqdn są modyfikowane zgodnie z oczekiwaniami.

Przykład 3. Zmiana etykiety domeny DNS publicznego adresu IP

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"

Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

Pierwsze polecenie pobiera zasób publicznego adresu IP o nazwie $publicIPName w $rgName grupy zasobów. Drugie polecenie ustawia właściwość DomainNameLabel na wymagany prefiks DNS. Set-AzPublicIPAddress polecenie aktualizuje zasób publicznego adresu IP za pomocą zaktualizowanego obiektu. DomainNameLabel i Fqdn są modyfikowane zgodnie z oczekiwaniami.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PublicIpAddress

Określa obiekt publicznego adresu IP reprezentujący stan, do którego należy ustawić publiczny adres IP.

Właściwości parametru

Typ:PSPublicIpAddress
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

PSPublicIpAddress

Dane wyjściowe

PSPublicIpAddress