Add-AzureVirtualIP

NAME Add-AzureVirtualIP



SYNOPSIS

Adds a virtual IP to a cloud service.





SYNTAX

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

[-InformationVariable <String>] [<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.





PARAMETERS

-ServiceName <String>

Specifies the name of the service.



Required? true

Position? 0

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-VirtualIPName <String>

Specifies the name of the virtual IP address.



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Profile <AzureSMProfile>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Microsoft.WindowsAzure.Commands.Utilities.Common.ManagementOperationContext







NOTES









-------------------------- 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.



RELATED LINKS

Add-AzureEndpoint

Remove-AzureVirtualIP