你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzCustomIpPrefix

Module:

Az.Network

Updates a CustomIpPrefix

Syntax

Update-AzCustomIpPrefix
      -Name <String>
      -ResourceGroupName <String>
      [-Commission]
      [-Decommission]
      [-Provision]
      [-Deprovision]
      [-NoInternetAdvertise]
      [-Cidr <String>]
      [-Tag <Hashtable>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzCustomIpPrefix
      -InputObject <PSCustomIpPrefix>
      [-Commission]
      [-Decommission]
      [-Provision]
      [-Deprovision]
      [-NoInternetAdvertise]
      [-Cidr <String>]
      [-Tag <Hashtable>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzCustomIpPrefix
      -ResourceId <String>
      [-Commission]
      [-Decommission]
      [-Provision]
      [-Deprovision]
      [-NoInternetAdvertise]
      [-Cidr <String>]
      [-Tag <Hashtable>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Update-AzCustomIpPrefix cmdlet allows the user to provision, commission, deprovision or decommission their CustomIpPrefix, or edit the tags or Cidr of the resource.

Examples

Example 1 : Commission the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Commission

The above command will start the commissioning process of the CustomIpPrefix.

Example 2 : Decommission the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Decommission

The above command will start the de-commissioning process of the CustomIpPrefix.

Example 3 : Provision the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Provision

The above command will start the provisioning process of the CustomIpPrefix.

Example 4 : Deprovision the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Deprovision

The above command will start the deprovisioning process of the CustomIpPrefix.

Example 5 : Update tags for the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Tag $tags

The above command will update the tags for the CustomIpPrefix.

Example 6 : Update CIDR for the CustomIpPrefix

Update-AzCustomIpPrefix -Name $prefixName -ResourceGroupName $rgName -Cidr $cidr

The above command will update the cidr for the CustomIpPrefix. This would work only when resource is in validationfailed state.

Parameters

-AsJob

Run cmdlet in the background

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Cidr

The CIDR to update.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Commission

Commission the CustomIpPrefix resource

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Decommission

start decommissioning process.

Type:	SwitchParameter
Aliases:	Decomission
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Deprovision

Deprovision the CustomIpPrefix resource

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

The CustomIpPrefix to set.

Type:	PSCustomIpPrefix
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

The resource name.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-NoInternetAdvertise

Commission the CustomIpPrefix resource with no internet advertise

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Provision

Provision the CustomIpPrefix resource

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

The resource group name.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-ResourceId

The resource Id.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Tag

A hashtable which represents resource tags.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

String

PSCustomIpPrefix

Hashtable

Outputs

PSCustomIpPrefix

Related Links

• Get-AzCustomIpPrefix
• New-AzCustomIpPrefix
• Remove-AzCustomIpPrefix