Add-AzureVirtualIP

Module:
Azure
Adds a virtual IP to a cloud service.

Syntax

Add-AzureVirtualIP
   [-ServiceName] <String>
   [-VirtualIPName] <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The Add-AzureVirtualIP cmdlet adds a new virtual IP (VIP) to your Azure service. The new virtual IP has a name but is not allocated an IP address.

The IP address is allocated only when you associate an endpoint to the VIP. See Add-AzureEndpoint for more details.

Your subscription is charged for extra VIPs only once they are associated with an endpoint.

Examples

Example 1: Add a virtual IP to a service

PS C:\> Add-AzureVirtualIP -VirtualIPName "Vip01" -ServiceName "ContosoService03"
OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Add-AzureVirtualIP   4bd7b638-d2e7-216f-ba38-5221233d70ce Succeeded

This command adds a virtual IP address to a service.

Required Parameters

-ServiceName

Specifies the name of the service.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VirtualIPName

Specifies the name of the virtual IP address.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-InformationAction

Specifies how this cmdlet responds to an information event.

The acceptable values for this parameter are:

  • Continue
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InformationVariable

Specifies an information variable.

Type:String
Aliases:iv
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

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

Outputs

Microsoft.WindowsAzure.Commands.Utilities.Common.ManagementOperationContext