Compartilhar via

  • Artigo

Get-CsArchivingPolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre suas diretivas de arquivamento de sessões de IM (mensagens instantâneas). Com as diretivas de arquivamento é possível arquivar todas as sessões de IM e de Webconferência entre usuários internos e/ou entre usuários internos e externos.

Sintaxe

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

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

Descrição Detalhada

Muitas organizações acham útil manter um arquivo de todas as sessões de IM das quais seus usuários participem; outras têm a obrigação legal de manter esse arquivo. Para arquivar sessões de IM com o Microsoft Lync Server 2010, é preciso realizar duas etapas. Primeiro, habilite o arquivamento em escopo global e/ou de site usando o cmdlet Set-CsArchivingConfiguration. Isso vai permitir o arquivamento de sessões de IM; entretanto, não implicará no arquivamento automático dessas sessões.

Para salvar as transcrições de suas sessões de IM, conclua a etapa 2: crie uma ou mais políticas de arquivamento de sessões de IM. Essas políticas determinam quais usuários terão suas sessões de IM gravadas e os tipos de sessões de IM (internas e/ou externas) que serão arquivadas. Sessões de IM internas são sessões nas quais todos os participantes são usuários autenticados com contas do Active Directory na sua organização; sessões de IM externas são sessões nas quais pelo menos um participante é um usuário não autenticado que não tem conta no Active Directory em sua organização. Você pode optar entre arquivar apenas sessões internas, apenas sessões externas ou ambas.

As diretivas de arquivamento (criadas com o cmdlet New-CsArchivingPolicy) podem ser atribuídas ao site global ou ao escopo de site. Além disso, essas diretivas podem ser atribuídas ao escopo por usuário, ou seja, uma diretiva pode ser criada e depois aplicada a um usuário específico, ou a um conjunto de usuários. Por exemplo, pode haver uma diretiva de global que arquiva sessões de IM internas de todos os seus usuários. Além disso, você pode criar uma segunda diretiva que arquive tanto sessões internas quanto externas, e aplicar essa diretiva à sua equipe de vendas. Como as diretivas por usuário têm precedência sobre as diretivas globais e de site, membros da equipe de vendas terão todas as suas sessões de IM arquivadas. Outros usuários (que não sejam parte do departamento de vendas e que portanto não são afetados pela diretiva de vendas) só terão suas sessões de IM internas arquivadas.

O cmdlet Get-CsArchivingPolicy oferece uma maneira de retornar informações sobre as diretivas de arquivamento que tenham sido configuradas para uso na organização. Tenha em mente que essas diretivas são aplicadas apenas se o arquivamento de sessão de IM tiver sido habilitado em escopo global ou de site. Para determinar se o arquivamento de sessão de IM foi habilitado, use o cmdlet Get-CsArchivingConfiguration.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo da diretiva de arquivamento a ser retornada. Para se referir à diretiva global, use esta sintaxe: -Identity global. Para se referir a uma diretiva de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para se referir a uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity RedmondArchivingPolicy. Se esse parâmetro for omitido, todas as diretivas de arquivamento configuradas para uso na organização serão retornadas.

Filter

Opcional

Cadeia de caracteres

Permite o uso de caracteres curinga ao indicar uma ou mais diretivas a serem retornadas. Por exemplo, para retornar todas as diretivas configuradas em escopo de site, use esta sintaxe: -Filter "site:*". Isso retorna diretivas nas quais o parâmetro Identity (a única propriedade pela qual se pode filtrar) comece com o valor de cadeia de caracteres "site:". Para retornar uma coleção de todas as diretivas por usuário que tenham uma identidade começando por "Sales", use esta sintaxe: -Filter "Sales*".

LocalStore

Opcional

Parâmetros de opção

Obtém os dados de diretiva de arquivamento 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-CsArchivingPolicy não aceita entrada em pipeline.

Tipos de Retorno

Get-CsArchivingPolicy retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.

Exemplo

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

Get-CsArchivingPolicy

O Exemplo 1 chama Get-CsArchivingPolicy sem nenhum parâmetro. Isso retorna uma coleção de todas as diretivas de arquivamento em uso na organização.

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

Get-CsArchivingPolicy -Identity site:Redmond

No Exemplo 2, Get-CsArchivingPolicy é usado para retornar a diretiva de arquivamento com a Identity site:Redmond. Como as identidades devem ser únicas, este comando sempre retornará, no máximo, uma única diretiva.

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

Get-CsArchivingPolicy -Filter tag:*

O comando anterior retorna uma coleção de todas as diretivas de arquivamento que tenham sido configuradas em escopo por usuário. Para isso, inclui-se o parâmetro Filter e o valor de filtro "tag:*". Esse valor de filtro instrui o cmdlet Get-CsArchivingPolicy a retornar somente as diretivas que tenham identidade começando com o valor de cadeia de caracteres "tag:".

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

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}

O Exemplo 4 retorna uma coleção de todas as diretivas de arquivamento nas quais o arquivamento de sessões de IM internas tenha sido desabilitada. Para isso, Get-CsArchivingPolicy é usado primeiro para retornar uma coleção de todas as diretivas de arquivamento em uso no momento. Esta coleção é então canalizada para o cmdlet Where-Object. Por sua vez, Where-Object aplica um filtro que restringe os dados retornados às diretivas onde a propriedade ArchiveInternal seja igual a False.

-------------------------- Exemplo 5 --------------------------

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}

O Exemplo 5 é semelhante ao Exemplo 4; no caso, porém, o comando retorna todas as diretivas de arquivamento nas quais os arquivamentos interno e externo estejam ambos desativados. Para isso, Get-CsArchivingPolicy é usado primeiro para retornar uma coleção de todas as diretivas de arquivamento em uso no momento. Essa coleção é então canalizada para para Where-Object, que seleciona apenas as diretivas nas quais as propriedades ArchiveInternal e ArchiveExternal sejam ambas iguais a False. O operador -and diz ao Where-Object para selecionar apenas as diretivas que atendam a todos os critérios especificados. Para selecionar diretivas que atendam a apenas um ou a ambos os critérios especificados, use o operador -or:

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}