New-CsCdrConfiguration

Sintaxe

New-CsCdrConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableCDR <$true | $false>] [-EnablePurging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepCallDetailForDays <UInt32>] [-KeepErrorReportForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O registro de detalhes das chamadas proporciona uma maneira de rastrear o uso de recursos do Microsoft Lync Server 2010, como chamadas telefônicas VoIP, mensagens instantâneas (IM), transferências de arquivos, conferências de áudio e vídeo (A/V) e sessões de compartilhamento de aplicativos. O CDR (que estará disponível apenas se você tiver implantado o serviço de monitoramento) acompanha as informações de uso: ele registra informações como as partes envolvidas na chamada, a duração da chamada e se os arquivos foram transferidos ou não. (no entanto, o CDR não grava a chamada em si).

O CDR também rastreia informações de erro de chamadas: dados de diagnóstico detalhados de sessões ponto a ponto e de chamadas de conferência.

Como um administrador, você pode determinar se o CDR é usado ou não na sua organização. Se o serviço de monitoramento tiver sido implementado, será possível habilitar ou desabilitar facilmente o CDR. Além disso, você pode tomar esta decisão globalmente (neste caso, o CDR vai ser habilitado ou desabilitado em toda a organização) ou de acordo com o site. Por exemplo: você pode usar o CDR no site de Redmond, mas não no site de Paris.

O cmdlet New-CsCdrConfiguration permite criar novas coleções de definições do CDR no escopo de site. (não é possível criar novas definições no escopo global.) Observe que um site pode hospedar apenas uma coleção de definições do CDR. Isso significa que não é possível criar uma nova coleção para o site de Redmond se ele já tiver um conjunto de definições de configuração do CDR. Se você tentar isso, o comando falhará.

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

Parâmetros

Tipos de Entrada

Nenhuma. New-CsCdrConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Cria instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallDetailRecording.CdrSettings.

Exemplo

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

New-CsCdrConfiguration -Identity site:Redmond -EnableCDR $False

O comando no Exemplo 1 usa o cmdlet New-CsCdrConfiguration, para criar um novo conjunto de definições do CDR com a Identidade site:Redmond. Além da Identidade site:Redmond, a propriedade EnableCDR das novas definições também está definida como False. Como as definições têm precedência sobre as definições globais, o CDR não será usado no site de Redmond, independentemente de o CDR ter sido habilitado ou não no escopo global.

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

$x = New-CsCdrConfiguration -Identity site:Redmond -InMemory
$x.EnableCDR = $False
Set-CsCdrConfiguration -Instance $x

O Exemplo 2 usa o parâmetro InMemory, para demonstrar como é possível criar uma nova coleção de definições de configuração do CDR que existem inicialmente apenas na memória. Para realizar isso, o exemplo primeiramente usa New-CsCdrConfiguration e o parâmetro InMemory, para criar uma coleção virtual de definições com a Identidade site:Redmond. Essa coleção virtual será armazenada na variável $x. Se a coleção não tiver sido armazenada em uma variável, então ela será criada e desaparecerá imediatamente.

Depois que a coleção virtual tiver sido criada, o comando exibido na linha 2 definirá como False ($False) o valor da propriedade EnableCDR. Na linha 3, utiliza-se Set-CsCdrConfiguration, para transformar a coleção virtual $x em uma coleção real de definições de configuração do CDR, que é aplicada ao site de Redmond. Se Set-CsCdrConfiguration não tiver sido chamado, a coleção virtual desapareceria assim que a sessão do Windows PowerShell fosse encerrada ou a variável $x fosse excluída.

Consulte Também

Outros Recursos

Get-CsCdrConfiguration
Remove-CsCdrConfiguration
Set-CsCdrConfiguration