Get-CsPstnUsage
Última modificación del tema: 2012-03-23
Devuelve información sobre los registros de uso de redes telefónicas conmutadas (PSTN) que se usan en su organización.
Sintaxis
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Los usos de PSTN son valores de cadenas de caracteres que se usan para la autorización de llamadas. Un uso de PSTN vincula una directiva de voz con una ruta. El cmdlet Get-CsPstnUsage recupera la lista de todos los usos de PSTN disponibles en una organización.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsPstnUsage de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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-CsPstnUsage"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
El nivel en el que se aplican estas configuraciones. La única identidad que se puede aplicar a los usos de PSTN es Global. |
Filter |
Opcional |
Cadena de caracteres |
El parámetro Filter permite recuperar únicamente los usos de PSTN con un valor de Identity que coincida con una cadena de comodines concreta. No obstante, el único valor de Identity disponible para los usos de PSTN es Global, por lo que este parámetro no es útil para este cmdlet. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera información de uso de RTC del almacenamiento de datos locales en lugar de Almacén de administración central principal. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Get-CsPstnUsage devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsPstnUsage
Este comando devuelve la lista de usos de PSTN globales que hay disponibles en una organización.
-------------------------- Ejemplo 2 --------------------------
(Get-CsPstnUsage).Usage
El comando de este ejemplo devuelve una lista de todos los usos de PSTN definidos, con un uso especificado en cada línea del resultado. Al llamar al mismo comando Get-CsPstnUsage, se obtiene el valor de Identity y la lista de usos. Si la lista de usos contiene más de tres o cuatro entradas, se abreviará en el resultado, de una forma simular a esta:
Usage : {Internal, Local, Long Distance, International...}
Use el comando de este ejemplo para mostrar solo una lista de usos. El resultado será similar a este:
Interno
Local
Long Distance
International
Restricted
-------------------------- Ejemplo 3 --------------------------
(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}
Este comando devuelve todos los nombres de usos de PSTN que contienen la cadena de caracteres "tern" en algún lugar del nombre. Por ejemplo, devolverá los nombres "Internal" e "International", pero no los nombres "Local" o "Long Distance".
La primera parte de este comando es el cmdlet Get-CsPstnUsage entre paréntesis, lo que significa que todos los usos de PSTN deben recuperar la primera cosa que sucede. La propiedad .Usage solo devuelve la información de uso sobre los usos de PSTN, no el valor de Identity. A continuación, la lista de usos se transfiere al cmdlet ForEach-Object, que analiza las cadenas de caracteres de usos una por una. La instrucción If compara la cadena de caracteres de uso actual con la cadena de caracteres "*tern*" (el * son caracteres comodín) y muestra las repeticiones que coinciden con el patrón.