New-AzureReservedIP
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
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 |
Specifies the reserved IP address name.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
Specifies a service name.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
Optional Parameters
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 |
Specifies an information variable.
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies a label for the reserved IP address.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True (ByPropertyName) |
| Accept wildcard characters: | False |
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 |
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 |
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 |