Set-CsPstnUsage
Tópico modificado em: 2012-03-25
Modifica um conjunto de cadeias de caracteres que identificam os usos da PSTN permitidos. Esse cmdlet pode ser usado para adicionar utilizações à lista de utilizações da PSTN ou remover utilizações da lista.
Sintaxe
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Os usos da PSTN são valores de cadeia de caracteres que são usados para a autorização de chamadas. Um uso da PSTN vincula uma política de voz a uma rota. O cmdlet Set-CsPstnUsage é usado para adicionar ou remover usos de telefone de e para a lista de uso. Esta lista é global, portanto pode ser usada por políticas e rotas de toda a implantação do Microsoft Lync Server 2010.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsPstnUsage localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnUsage"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsIdentity |
O escopo no qual se aplicam estas definições. A identidade deste cmdlet é sempre Global. |
Instance |
Opcional |
PstnUsages |
Uma referência a um objeto de uso da PSTN. Esse objeto deve ser do tipo PstnUsages e pode ser recuperado chamando-se Get-CsPstnUsage. |
Usage |
Opcional |
PSListModifier |
Contém uma lista de cadeias de caracteres de uso disponíveis. Estas entradas podem ser de qualquer valor de cadeia de caracteres. |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações. |
WhatIf |
Opcional |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages. Aceita entradas canalizadas de objetos de utilizações da PSTN.
Tipos de Retorno
Este cmdlet não retorna um valor ou um objeto. Em vez disso, ele configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
Este comando adiciona a cadeia de caracteres "Internacional" à lista atual de usos da PSTN disponíveis.
-------------------------- Exemplo 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
Este comando remove a cadeia de caracteres "Local" da lista de usos da PSTN disponíveis.
-------------------------- Exemplo 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
Neste exemplo, o comando desempenha a mesma ação que no Exemplo 2: ele remove o uso da PSTN "Local". Este exemplo mostra o comando sem o parâmetro Identity especificado. A única identidade disponível para o cmdlet Set-CsPstnUsage é a identidade Global. A omissão do parâmetro Identity causará a adoção do padrão Global.
-------------------------- Exemplo 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
Este comando substitui tudo na lista de usos pelos valores Internacional e Restrito. Todos os usos existentes anteriormente serão removidos.