Compartilhar via

  • Artigo

Get-CsVoicePolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre uma ou mais políticas de voz configuradas para a organização.

Sintaxe

Get-CsVoicePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Descrição Detalhada

Este cmdlet recupera as informações sobre políticas de voz. As políticas de voz são usadas para gerenciar tais recursos relacionados ao Enterprise Voice como o toque simultâneo (a capacidade de ter um segundo toque telefônico a cada vez que alguém chamar o seu telefone de escritório) e o encaminhamento de chamadas. Use este cmdlet para recuperar as configurações que habilitam e desabilitam muitos destes recursos.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsVoicePolicy localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Um identificador exclusivo que especifica o escopo e, em alguns casos o nome, da política. Se este parâmetro for omitido, serão retornadas todas as políticas de voz da organização.

Filter

Opcional

Cadeia de caracteres

Este parâmetro aceita uma cadeia de caracteres curinga e retorna todas as políticas de voz cuja identidade coincidir com a cadeia de caracteres. Por exemplo, o valor de Filter site:* retornará todas as políticas de voz definidas no nível do site.

LocalStore

Opcional

SwitchParameter

Recupera a política de voz da réplica local do Repositório de Gerenciamento Central em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy.

Exemplo

-------------------------- Exemplo 1 --------------------------

Get-CsVoicePolicy

Este exemplo exibe todas as políticas de voz que tiverem sido definidas em uma organização, juntamente com as respectivas definições.

-------------------------- Exemplo 2 --------------------------

Get-CsVoicePolicy -Identity UserPolicy1

Este exemplo usa o parâmetro Identity para recuperar as definições da política de voz por usuário denominada UserPolicy1.

-------------------------- Exemplo 3 --------------------------

Get-CsVoicePolicy -Filter tag*

Este exemplo usa o parâmetro Filter para recuperar todas as definições de política de voz que puderem ser atribuídas a usuários. Todas as políticas de voz de usuário têm uma identidade no formato marca:<UserVoicePolicy>, portanto filtra-se a marca para recuperar todas as políticas de voz de usuário.