Compartilhar via

  • Artigo

Get-CsArchivingConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre como (ou se) as sessões de IM serão arquivadas na organização.

Sintaxe

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

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

Descrição Detalhada

Muitas organizações consideram útil manter uma transcrição de todas as sessões de mensagens instantâneas realizadas por seus usuários (ou um subconjunto selecionado de usuários). Para outras, é obrigatório manter essas transcrições. Por exemplo, a lei exige que muitas organizações no mundo financeiro mantenham cópias de todas as suas comunicações eletrônicas.

O Microsoft Lync Server 2010 proporciona a flexibilidade para arquivar sessões de mensagens instantâneas e webconferências. Se você tiver implantado o Servidor de Arquivamento, poderá utilizar diversos cmdlets CsArchivingConfiguration para habilitar e desabilitar o arquivamento de mensagens instantâneas, e para gerenciar o banco de dados de arquivamento. Também é possível suspender a IM, caso o arquivamento falhe; isso ajuda a garantir a manutenção de um registro de todas as comunicações eletrônicas.

Para arquivar as sessões de IM, será necessário configurar pelo menos um Servidor de Arquivamento. Depois que o Servidor de Arquivamento tiver sido configurado, será necessário realizar duas etapas adicionais. Primeiramente, será necessário habilitar o arquivamento no escopo apropriado (para obter detalhes, consulte o tópico Set-CsArchivingConfiguration). Apesar de este ser o escopo global, também é possível configurar as definições de arquivamento personalizadas para diferentes sites.

Segundo, será necessário usar políticas de arquivamento para indicar quais usuários terão suas sessões de IM arquivadas. O que acontecerá se você permitir o arquivamento, mas não atribuir a nenhum usuário uma política que especifique que suas sessões de IM devam ser arquivadas? Literalmente, nada acontecerá: As sessões de IM não serão arquivadas, a menos que uma política em vigor exija o seu arquivamento.

Graças ao cmdlet Get-CsArchivingConfiguration, é possível determinar como foi configurado o arquivamento das sessões de IM na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsArchivingConfiguration 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 (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Indica o identificador exclusivo da coleção de definições de arquivamento que se deseja retornar. Para se referir às definições globais, utilize essa sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se precisar utilizar caracteres curinga, inclua o parâmetro Filter no seu lugar.

Se esse parâmetro não for especificado, Get-CsArchivingConfiguration retornará uma coleção de todas as definições de configuração de arquivamento em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga para retornar uma coleção (ou coleções) de definições de configuração de arquivamento. Para retornar uma coleção de todas as definições configuradas no escopo de site, utilize esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as definições que tiverem o valor da cadeia de caracteres "Canada" em alguma posição de sua identidade (a única propriedade que se pode filtrar), utilize esta sintaxe: -Filter "*Canada*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de arquivamento na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsArchivingConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsArchivingConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Exemplo

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

Get-CsArchivingConfiguration

O comando apresentado no Exemplo 1 retorna uma coleção de todas as definições de configuração de arquivamento em uso na organização.

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

Get-CsArchivingConfiguration -Identity site:Redmond

No exemplo anterior, o parâmetro Identity é usado para limitar a coleção retornada de definições de configuração de arquivamento às definições que possuírem a Identidade site:Redmond.

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

Get-CsArchivingConfiguration -Filter site:*

No exemplo 3, o parâmetro Filter é usado para limitar a coleção retornada de definições de configuração de arquivamento às definições que tiverem sido configuradas no escopo de site. O valor de parâmetro "site:*" limita os itens retornados àqueles que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "site:".

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -ne "None"}

Esse exemplo utiliza Get-CsArchivingConfiguration para retornar uma coleção de todas as definições de configuração de arquivamento que tiverem sido habilitadas para uso na organização. Para fazer isso, o comando primeiramente chama Get-CsArchivingConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as definições de configuração de arquivamento. Esta coleção será então canalizada para o cmdlet Where-Object, que aplicará um filtro que limita os dados retornados às coleções cuja propriedade EnableArchiving for igual a "None". Se EnableArchiving estiver definido como "None", o arquivamento será desabilitado. Se essa propriedade for definida para qualquer outro valor (seja "IMOnly" ou "ImAndWebConf"), o arquivamento será habilitado.