Get-CsCallParkOrbit

 

Topic Last Modified: 2012-03-23

Gets the call park orbit range settings for the organization.

Syntax

Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]

Detailed Description

This cmdlet retrieves the settings for the call park orbits defined for an organization. You can retrieve a single call park orbit range (specified by the Identity parameter) or you can call Get-CsCallParkOrbit with no parameters to retrieve all the call park orbit ranges defined for an organization. Call park orbits are composed of settings that specify a range of numbers at which a user can park a call and the servers associated with those number ranges.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsCallParkOrbit cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCallParkOrbit"}

Parameters

Parameter Required Type Description

Identity

Optional

String

The unique name of the call park orbit range. This name was assigned by the administrator when the call park orbit range was defined.

Filter

Optional

String

This parameter accepts a wildcard string and returns all call park orbit ranges with identities matching that string. For example, a Filter value of Redmond* will return all call park orbit ranges with names beginning with the string Redmond, such as Redmond 1, Redmond 2, RedmondCPO, etc.

LocalStore

Optional

Guid

Retrieves the call park orbit information from the local replica of the Central Management store, rather than the Central Management store itself.

Input Types

None.

Return Types

This cmdlet returns an object of type Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits.

Example

-------------------------- Example 1 --------------------------

Get-CsCallParkOrbit

In this example, Get-CsCallParkOrbit is called without specifying any additional parameters. When called like this, Get-CsCallParkOrbit returns a collection of all the call park orbit ranges configured for use in your organization.

-------------------------- Example 2 --------------------------

Get-CsCallParkOrbit -Identity "Redmond CPO 1"

In the preceding example, Get-CsCallParkOrbit is used to return information about the call park orbit range with the name "Redmond CPO 1".

-------------------------- Example 3 --------------------------

Get-CsCallParkOrbit -Filter *Redmond*

The command in this example returns all call park orbit ranges with the string "Redmond" in their Identity. For example, this command will return call park orbits with identities such as "Redmond 501", "CP Redmond 1", and "ARedmond". The command uses the Filter parameter with the wildcard character (*) to designate what to search for. (This search is not case sensitive.)

-------------------------- Example 4 --------------------------

Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}

This command returns all call park orbit ranges assigned to the call park service with the ID ApplicationServer:pool0.litwareinc.com. The Get-CsCallParkOrbit cmdlet retrieves a collection of all call park orbit ranges, and then pipes that collection to the Where-Object cmdlet. This call to Where-Object finds all call park orbits in that collection with a value of ApplicationServer:pool0.litwareinc.com in their CallParkServiceId properties. Notice that we add the toString method to the end of the CallParkServiceId parameter name. The CallParkServiceId is of type WritableServiceId. In order to compare that value to the supplied string, we must first turn it into a string by calling the toString method.

-------------------------- Example 5 --------------------------

Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}

The command in this example returns all call park orbit ranges where the range of numbers starts with an * prefix. After Get-CsCallParkOrbit retrieves a collection of all the call park orbit ranges, the collection is then piped to Where-Object. Where-Object narrows the collection to only those call park orbit ranges that have a call park location starting with a *. It does this by checking the StartsWith property of the NumberRangeStart object for the string "*".

-------------------------- Example 6 --------------------------

Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}

The command in this example returns all call park orbit ranges where no prefix has been assigned to the numbers in the range. (A prefix is the value * or # placed at the beginning of the number.) All call park orbits returned by this command will have ranges that consist only of numbers with no other characters included. Get-CsCallParkOrbit retrieves a collection of all the call park orbit ranges, and then that collection is piped to Where-Object. Looking at the criteria in the call to Where-Object, we see this: $_.NumberRangeStart[0]). This returns the first character in the number at the start of the range. (Note that we need to check only the start of the range--if the starting number in the range doesn’t have a prefix, neither will the ending number.) This character is passed to the IsDigit function to determine whether it is a numeric character. If it is, the call park orbit information for the corresponding collection item will be returned.