New-​Azure​Reserved​IP

Creates a reserved IP address.

Syntax

New-AzureReservedIP
   [-ReservedIPName] <String>
   [[-Label] <String>]
   [-Location] <String>
   [-ServiceName] <String>
   [[-VirtualIPName] <String>]
   [[-Slot] <String>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The New-AzureReservedIP cmdlet creates a reserved IP address.

Examples

Example 1: Create a new reserved IP

PS C:\> New-AzureReservedIP -ReservedIPName $Name -Label $Label -Location $Location

This command creates a new reserved IP address in the subscription, which can be used for creating cloud services that include Web, Worker, and Virtual Machines.

Example 2: Create a reserved IP based on an existing IP

PS C:\> New-AzureReservedIP -ReservedIPName resip14 -Location "West Europe" -ServiceName piptestwesteurope

This command creates an existing VIP (Virtual IP) on the specified service.

Required Parameters

-Location

Specifies a location at which to create the reserved IP address.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ReservedIPName

Specifies the reserved IP address name.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ServiceName

Specifies a service name.

Type:String
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
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
-Label

Specifies a label for the reserved IP address.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
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
-Slot

Specifies the deployment slot. The acceptable values for this parameter are: Staging, Production.

Type:String
Position:5
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-VirtualIPName

Specifies that this cmdlet uses the VirtualIPName parameter to reserve an existing virtual IP address (VIP) in your deployment. If this parameter is not specified, this cmdlet reserves a new VIP.

Type:String
Position:4
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False