Compartilhar via

  • Artigo

Get-CsCdrConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações a respeito das configurações do registro de detalhes da suas chamadas (CDR). O CDR permite acompanhar o uso de coisas como sessões de mensagens instantâneas ponto a ponto, chamadas de telefone VoIP e chamadas de conferência.

Sintaxe

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

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

Descrição Detalhada

O CDR (registro de detalhes das chamadas) fornece um meio de acompanhar o uso das capacidades do Microsoft Lync Server 2010, tais como chamadas telefônicas VoIP, IM (mensagens instantâneas), transferência de arquivos, conferência de A/V (áudio/vídeo) e sessões de compartilhamento de aplicativos. CDR (que está disponível somente se você tiver implementado o serviço de Monitoramento) mantem informações de uso: registra informações tais como as partes envolvidas na ligação, a duração da chamada e se algum arquivo foi transferido. (porém, o CDR não grava a chamada em si).

CDR também acompanha informações de erro da chamada: dados do diagnóstico detalhado para as sessões ponto a ponto e para chamadas de conferência.

Como um administrador, você pode determinar se CDR é usado na sua organização. Se o serviço de Monitoramento tiver sido implementado, você pode habilitar ou desabilitar o CDR. Além disso, você pode fazer esta decisão globalmente (neste caso CDR vai ou ser habilitado ou desabilitado através da organização) ou em uma base de site a site; por exemplo, você pode usar CDR no site Redmond mas não usar CDR no site Paris.

O cmdlet Get-CsCdrConfiguration oferece um meio de retornar informações detalhadas sobre como o CDR é usado na sua organização.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsCdrConfiguration 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-CsCdrConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Indica um identificador único para a coleção de configurações CDR que você quer retornar. Para referir-se a configurações globais, use esta sintaxe: -Identity global. Para referir-se à coleção configurada no escopo do site, use a sintaxe similar a esta: -Identity site:Redmond. Note que você não pode usar curingas quando especificando uma Identity. Se for necessário usar curingas, use o parâmetro Filter.

Se este parâmetro não for especificado, então Get-CsCdrConfiguration retorna uma coleção de todas as configurações de CDR atualmente em uso na organização.

Filter

Opcional

Cadeia de caracteres

Habilita você a usar caracteres curinga a fim de retornar uma coleção de configurações do CDR. Por exemplo, para retornar uma coleção de todas as configurações definidas em escopo de site, use esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as configurações que têm um valor de cadeia de caracteres "Western" em alguma parte de sua Identidade, use a sintaxe: -Filter *Western*.

LocalStore

Opcional

Parâmetros de Opção

Obtém os dados de configuração de CDR a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsCdrConfiguration não aceita entrada em pipeline.

Tipos de Retorno

Get-CsCdrConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.

Exemplo

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

Get-CsCdrConfiguration

Este exemplo usa Get-CsCdrConfiguration para retornar uma coleção de todas as configurações do CDR definidas para uso em sua organização.

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

Get-CsCdrConfiguration -Identity site:Redmond

O Exemplo 2 usa o parâmetro Identity para retornar uma única coleção de configurações de CDR: as configurações com Identidade site:Redmond.

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

Get-CsCdrConfiguration -Filter site:*

No Exemplo 3, o parâmetro Filter é empregado para retornar todas as configurações do CDR que tenham sido definidas no escopo do site. O valor do filtro "site:*" retorna todas as configurações de CDR que têm uma Identity que começa com a cadeia de caracteres "site:" Por definição, estas são configurações que foram definidas no escopo do site.

-------------------------- Exemplo 4 --------------------------

Get-CsCdrConfiguration | Where-Object {$_.KeepCallDetailForDays -lt 30}

O exemplo anterior retorna uma coleção de todas as configurações de CDR onde a propriedade KeepCallDetailForDays for menor do que 30 dias. Para fazer isto, o comando primeiro usa Get-CsCdrConfiguration para retornar a coleção de todas as configurações de CDR definidas na organização. Essa coleção é então encaminhada para o cmdlet Where-Object, que seleciona somente as configurações nas quais o valor de KeepCallDetailForDays seja menor do que 30 dias.