Get-CsPstnUsage
Tópico modificado em: 2012-03-23
Retorna informações sobre registros de uso da PSTN (rede telefônica pública comutada) em sua organização.
Sintaxe
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Os usos da PSTN são valores de cadeia de caracteres que são usados para autorização de chamada. O uso de PSTN vincula uma diretiva de voz a uma rota. O cmdlet Get-CsPstnUsage recupera a lista de todos os usos de PSTN disponíveis dentro de uma organização.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsPstnUsage localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPstnUsage"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsIdentity |
O nível ao qual estas configurações são aplicadas. A única identidade que pode ser aplicada aos usos de PSTN é a Global. |
Filter |
Opcional |
Cadeia de caracteres |
O parâmetro Filter permite que recuperar apenas os usos de PSTN com uma identidade correspondendo a uma cadeia de caracteres curinga específica. Entretanto, a única identidade disponível para usos de PSTN é a Global, então este parâmetro não será útil para este cmdlet. |
LocalStore |
Opcional |
SwitchParameter |
Recupera as informações de uso da PSTN a partir do armazenamento de dados local, e não do Repositório de Gerenciamento Central principal. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Get-CsPstnUsage retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsPstnUsage
Este comando retorna a lista de uso de PSTN global disponível dentro da organização.
-------------------------- Exemplo 2 --------------------------
(Get-CsPstnUsage).Usage
O comando neste exemplo retorna uma lista de todos os usos de PSTN definidos, com um uso listado em cada linha de saída. Quando Get-CsPstnUsage é chamado sozinho, ele retorna a identidade e a lista de usos. Se a lista de uso tiver mais de três ou quatro entradas, a lista estará abreviada na saída, semelhante a este:
Uso: {Interna, Local, Interurbano, Internacional...}
Use o comando neste exemplo para exibir somente uma lista de usos. A saída será semelhante a esta:
Interno
Local
Interurbano
Internacional
Restricted
-------------------------- Exemplo 3 --------------------------
(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}
Este comando retorna todos os nomes de uso de PSTN que tenham a cadeia de caracteres "tern" em qualquer lugar do nome. Por exemplo, este comando retornará "Interno" e "Internacional", mas não "Local" ou "Interurbano".
A primeira parte deste comando é o cmdlet Get-CsPstnUsage entre parênteses, que significa que a primeira coisa que acontece é a recuperação de todos os usos da PSTN. A propriedade .Usage retorna apenas as informações de uso da PSTN, e não a identidade. Esta lista de usos é, então, canalizada para o cmdlet ForEach-Object, que procura as cadeias de caracteres de uso um de cada vez. A declaração se compara à cadeia de caracteres de uso atual com a cadeia de caracteres "*tern*" (o * são caracteres curingas) e exibe qualquer ocorrência que combina com o padrão.