This is an archive version of the document. To get the most up-to-date information, see the current version.

Remove-VBRCloudPublicIP

In this article

Short Description

Removes IP addresses from public IP addresses pools.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Requires a VCP license.

Syntax

Remove-VBRCloudPublicIP -CloudIp <VBRCloudIP[]> [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Return Type

None

Detailed Description

This cmdlet removes a selected IP address from the public IP addresses pool.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
CloudIp	Specifies the array of IP addresses that you want to remove.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
WhatIf	Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.	False	Named	False	False
Confirm	Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This example shows how to remove the first IP address from the configured pool of public IP addresses.

Run Get-VBRCloudPublicIP to get the pool of IP addresses. Save the pool to the $ip variable.
Run Remove-VBRCloudPublicIP to remove the first IP address. Use the $ip variable.

PS C:\PS> $ip = Get-VBRCloudPublicIP

PS C:\PS> Remove-VBRCloudPublicIP –CloudIP $ip[0]

Example 2

This example shows how to remove all IP addresses assigned to the cloud tenant named “ABC Company”.

Run Get-VBRCloudTenant to get the tenant. Save the result to the $tenant variable.
Run Get-VBRCloudPublicIP to get the pool of IP addresses allocated to the tenant. Use the $tenant variable. Save the result to the $ip variable.
Run Remove-VBRCloudPublicIP to remove the IP addresses. Use the $ip variable.

PS C:\PS> $tenant = Get-VBRCloudTenant –Name "ABC Company"

PS C:\PS> $ip = Get-VBRCloudPublicIP –Tenant $tenant

PS C:\PS> Remove-VBRCloudPublicIP –CloudIP $ip