Get-CsCallParkOrbit
Última modificación del tema: 2012-03-23
Obtiene las configuraciones de intervalo de órbitas de estacionamiento de llamadas de la organización.
Sintaxis
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Este cmdlet recupera las configuraciones de las órbitas de estacionamiento de llamadas definidas en una organización. Puede recuperar un intervalo de órbita de estacionamiento de llamadas determinada (especificada con el parámetro Identity) o llamar a Get-CsCallParkOrbit sin parámetros para recuperar todos los intervalos de órbitas de estacionamiento de llamadas definidos en una organización. Las órbitas de estacionamiento de llamadas están formadas por configuraciones que especifican un intervalo de números en el que un usuario puede estacionar una llamada y los servidores asociados con dichos intervalos.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsCallParkOrbit localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCallParkOrbit"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Nombre único del intervalo de órbita de estacionamiento de llamadas. Este nombre lo especifica el administrador al definir el intervalo de órbita de estacionamiento de llamadas. |
Filter |
Opcional |
Cadena de caracteres |
Este parámetro acepta una cadena de caracteres con comodín y devuelve todos los intervalos de órbitas de estacionamiento de llamadas con identidades que coincidan con la cadena. Por ejemplo, una propiedad Filter con el valor Redmond* devolverá todos los intervalos de órbitas de estacionamiento de llamadas con nombres que comiencen por Redmond, como Redmond 1, Redmond 2 y RedmondCPO, etc. |
LocalStore |
Opcional |
Identificador único global |
Recupera la información de órbita de estacionamiento de llamada desde la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Este cmdlet devuelve un objeto de tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsCallParkOrbit
En este ejemplo, se llama a Get-CsCallParkOrbit sin especificar ningún parámetro adicional. Con este tipo de llamada, Get-CsCallParkOrbit devuelve una recopilación de todos los intervalos de órbitas de estacionamiento de llamadas configuradas en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
En el ejemplo anterior se usa Get-CsCallParkOrbit para devolver información sobre el intervalo de órbita de estacionamiento de llamadas con el nombre "Redmond CPO 1".
-------------------------- Ejemplo 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
El comando de este ejemplo devuelve todos los intervalos de órbitas de estacionamiento de llamadas con la cadena de caracteres "Redmond" en la propiedad Identity. Por ejemplo, devolverá órbitas de estacionamiento de llamadas con identidades como "Redmond 501", "CP Redmond 1" y "ARedmond". El comando usa el parámetro Filter con el carácter comodín (*) para definir la búsqueda. (Esta búsqueda no distingue mayúsculas y minúsculas).
-------------------------- Ejemplo 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
Este comando devuelve todos los intervalos de órbitas de estacionamiento de llamadas asignadas al servicio de estacionamiento de llamadas con el identificador ApplicationServer:pool0.litwareinc.com. El cmdlet Get-CsCallParkOrbit recupera una recopilación de todos los intervalos de órbitas de estacionamiento de llamadas y la canaliza al cmdlet Where-Object. Esta llamada a Where-Object busca todas las órbitas de estacionamiento de llamadas de la recopilación que tengan el valor ApplicationServer:pool0.litwareinc.com en las propiedades CallParkServiceId. Tenga en cuenta que agregamos el método toString al final del nombre del parámetro CallParkServiceId. CallParkServiceId es de tipo WritableServiceId. Para comparar ese valor a la cadena proporcionada, primero debemos transformarla en una cadena llamando al método toString.
-------------------------- Ejemplo 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
El comando en este ejemplo devuelve todos los intervalos de órbitas de estacionamiento de llamadas en las que el intervalo de números comienza con el prefijo *. Después de que Get-CsCallParkOrbit recupere una recopilación de todos los intervalos de órbitas, esta se transfiere a Where-Object. Where-Object restringe la recopilación solo a los intervalos de órbitas de estacionamiento de llamadas cuya ubicación de estacionamiento de llamadas comienza con *. Para ello, comprueba si la propiedad StartsWith del objeto NumberRangeStart contiene "*".
-------------------------- Ejemplo 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
El comando de este ejemplo devuelve todos los intervalos de órbitas de estacionamiento de llamadas en las que no se ha asignado un prefijo a los números del intervalo. (Un prefijo es el valor * o # situado al principio del número). Todas las órbitas de estacionamiento de llamadas que devuelve este comando tendrán intervalos formados solo por números, sin ningún otro carácter. Get-CsCallParkOrbit recupera una recopilación de todos los intervalos de órbitas, que se transfiere a Where-Object. Observando los criterios de la llamada a Where-Object, podemos ver lo siguiente: $_.NumberRangeStart[0]). Devuelve el primer carácter del número al principio del intervalo. (Solo es necesario comprobar el principio del intervalo; si el número inicial en el intervalo no tiene un prefijo, tampoco lo tendrá el número final). Este carácter se envía a la función IsDigit para determinar si se trata de un carácter numérico. Si lo es, se devolverá la información de órbita de estacionamiento de llamadas del elemento de recopilación correspondiente.