< Back

New-AzureReservedIP

Wed Jan 30, 2019 5:48 pm

NAME New-AzureReservedIP



SYNOPSIS

Creates a reserved IP address.





SYNTAX

New-AzureReservedIP [-ReservedIPName] <String> [[-Label] <String>] [-Location] <String> [-ServiceName] <String> [[-VirtualIPName] <String>] [[-Slot]

<String>] [-Profile <AzureSMProfile>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]





DESCRIPTION

The New-AzureReservedIP cmdlet creates a reserved IP address.





PARAMETERS

-ReservedIPName <String>

Specifies the reserved IP address name.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Label <String>

Specifies a label for the reserved IP address.



Required? false

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Location <String>

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



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

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



-ServiceName <String>

Specifies a service name.



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VirtualIPName <String>

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.



Required? false

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Slot <String>

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



Required? false

Position? 5

Default value None

Accept pipeline input? True (ByPropertyName)

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



NOTES









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

-------------------------- Example 3: Create a new reserved IP with iptaglist --------------------------



PS C:\\>New-AzureReservedIP -ReservedIPName $Name -Label $Label -Location $Location -IPTagList $tag1, $tag2



This command creates a new reserved IP address for a subscription from given tagged ranges



RELATED LINKS

Get-AzureReservedIP

Remove-AzureReservedIP