Invoke-AzPublicIpAddressCloudServiceReservation

為雲端服務的公共 IP 位址保留或回滾分配。

語法

ByName (預設值)

Invoke-AzPublicIpAddressCloudServiceReservation
    -Name <String>
    -ResourceGroupName <String>
    [-IsRollback]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

ByInputObject

Invoke-AzPublicIpAddressCloudServiceReservation
    -InputObject <PSPublicIpAddress>
    [-IsRollback]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

ByResourceId

Invoke-AzPublicIpAddressCloudServiceReservation
    -ResourceId <String>
    [-IsRollback]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Description

Invoke-AzPublicIpAddressCloudServiceReservation cmdlet 會呼叫目標公開 IP 上的 ReserveCloudServicePublicIpAddress 操作。 預設情況下,它會保留雲端服務的公共 IP(靜態分配)。 當指定 IsRollback 時,操作會從靜態分配回復為動態配置(還原保留)。

此指令小程式支援 WhatIfConfirm (見 about_CommonParameters)。

範例

範例一:使用資源群組和名稱的保留

Invoke-AzPublicIpAddressCloudServiceReservation -ResourceGroupName 'myResourceGroup' -Name 'myCloudServicePublicIp'

myResourceGroup 中保留名為 myCloudServicePublicIp 的雲端服務公共 IP。

範例 2:回滾預留(動態分配)

Invoke-AzPublicIpAddressCloudServiceReservation -ResourceGroupName 'myResourceGroup' -Name 'myCloudServicePublicIp' -IsRollback

將公共 IP 從靜態還原為動態分配,針對同一資源。

範例 3:管道連接公共 IP 物件

$pip = Get-AzPublicIpAddress -ResourceGroupName 'myResourceGroup' -Name 'myCloudServicePublicIp'
Invoke-AzPublicIpAddressCloudServiceReservation -InputObject $pip

使用 Get-AzPublicIpAddress 中的 PSPublicIpAddress 執行保留操作。

參數

-AcquirePolicyToken

自動取得 Azure 原則 令牌以進行此資源操作。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AsJob

在背景執行 Cmdlet

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ChangeReference

變更參考資源 ID,用於此資源操作。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 Azure 通訊的憑證、帳號、租戶和訂閱。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InputObject

公共 IP 位址物件。

參數屬性

類型:PSPublicIpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ByInputObject
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IsRollback

當為真時,會從靜態分配回復為動態分配(還原保留)。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

公共 IP 位址名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ResourceName

參數集

ByName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ResourceGroupName

資源群組名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ByName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ResourceId

公共 IP 位址資源 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ByResourceId
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

String

PSPublicIpAddress

輸出

PSPublicIpAddress