New-UdmRmNumberReservation

Reserves a number in the Range specified

ItemComment
Availability versionVersion 1.0
Initial release dateJune 27, 2017
Last updated onJune 27, 2017
Related toRanger Documentation

Syntax

New-UdmRmNumberReservation -DID|-EXT -Range <String> -ServiceID <string> -ServiceProvider <string>] [<CommonParameters>]

Parameters

ParameterDescriptionClassAccepted optionsDefaultUsageUniqueAvailable from version
-DID | -EXTSpecifies if it is a DID or EXT range.System.String
-DIDOptional
v1.0
Range

The phone number range you want the number returned from

System.String

Required
 v1.0
ReservedMinutesThe number of minutes to reserve the number for. Specifying 0 reserves the number foreverSystem.String
60Optional
v1.0

Output

Field NameDescription
idThe GUID of the phone number reserved
didThe DID/DDI number reserved
extensionThe extension of the reserved number if applicable
normalisedNumberThe number reserved (and extension if applicable) in its normalised format
noteAny note associated with the number
reservedWill be set to True as the number has been reserved
reservedUntilDate and time the number is reserved until. Note this is UTC ISO8601 format. 
YYYY-MM-DDThh:mm:ssZ 
phoneNumberBlockIdGUID for the phone number block the number is in
phoneNumberBlockFull details of the phone number block
allocatedIs the number allocated in AD this will be False
usersUser name associated with the number this will be Null
contactsContact name associated with the number this will be Null

Examples

Example 1 

In example 1, the New-UdmRmNumberReservation cmdlet reserves a number for 60 mins in the Boston range. It returns the number and the time the number is reserved until.

New-UdmRmNumberReservation -range Boston 

Example 2

In example 2, reserves a number in the Boston range if there is a number in a block where the Service Provider is Verizon. The number is reserved for 10 mins.

New-UdmRmNumberReservation -range Boston -reservedminutes 10