Compartilhar via

  • Artigo

Set-CsArchivingPolicy

 

Tópico modificado em: 2012-03-26

Modifica uma política existente de arquivamento de mensagens instantâneas (IM). As políticas de arquivamento permitem arquivar todas as sessões de IM e conferências que ocorrerem entre usuários internos; é possível também arquivar sessões que ocorrerem entre usuários internos e parceiros federados.

Sintaxe

Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Muitas organizações consideram isso útil para manter um arquivo de todas as sessões de IM das quais seus usuários participarem. A lei exige que outras organizações mantenham este arquivo. Para arquivar as sessões de IM com Microsoft Lync Server 2010, devem-se executar dois passos. Primeiro, é preciso ativar o arquivamento do escopo do site global e/ou utilizar o cmdlet Set-CsArchivingConfiguration. Isso possibilita arquivar sessões de IM, porém não inicia automaticamente o arquivamento dessas sessões.

Para salvar as transcrições das sessões de IM, deve-se concluir a segunda etapa: crie uma ou mais políticas de arquivamento que determinam quais usuários terão suas sessões de IM registradas e o tipo de sessão IM (interna e/ou externa) que será arquivado. Nas sessões de IM internas, todos os participantes são usuários autenticados com contas do Active Directory na organização; nas sessões de IM externas, pelo menos um participante é um usuário não-autenticado sem uma conta do Active Directory na organização. É possível optar por arquivar somente as sessões internas, as externas ou ambas.

É possível atribuir as políticas de arquivamento (criadas utilizando-se o cmdlet New-CsArchivingPolicy) ao site global ou ao escopo do site. Além disso, essas políticas podem ser atribuídas ao escopo por usuário; isso significa que uma política pode ser criada e então aplicada a um usuário específico ou a um grupo de usuários. Por exemplo, é possível adotar uma política global que arquive as sessões de IM internas de todos os usuários. Além disso, é possível criar uma segunda política, que arquive as sessões internas e externas e aplicá-la apenas ao pessoal de vendas. Como as políticas por usuário têm precedência sobre as políticas globais e de site, todas as sessões de IM dos membros da equipe de vendas serão arquivadas. Apenas as sessões de IM internas de outros usuários (ou seja, os que não fizerem parte do departamento de vendas e que, portanto, não são afetados pela política de vendas) serão arquivadas.

O cmdlet Set-CsArchivingPolicy permite modificar os valores de propriedade de qualquer política de arquivamento de sessões de IM em uso na organização.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador único da política de arquivamento a ser modificada. As políticas de arquivamento podem ser configuradas nos escopos global, de site ou por usuário. Para modificar a política global, utilize a seguinte sintaxe: -Identity global. Para modificar a política de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Para modificar uma política por usuário, utilize uma sintaxe similar a esta: -Identity SalesArchivingPolicy. Se este parâmetro não for especificado, a política global será modificada.

Não se permite o uso de caracteres curinga quando se especifica uma identidade.

Instance

Opcional

Objeto IMArchivingPolicy

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

ArchiveExternal

Opcional

Booleano

Indica se as sessões de IM externas serão arquivadas. (uma sessão de IM externa é aquela na qual pelo menos um dos participantes é um usuário autenticado e sem uma conta do Active Directory na organização.) O valor padrão é False, indicando que as sessões de IM que incluírem usuários externos não serão arquivadas.

ArchiveInternal

Opcional

Booleano

Indica se as sessões de IM internas serão arquivadas. (uma sessão de IM interna é aquela na qual todos os participantes são usuários autenticados e com contas do Active Directory na organização.) O valor padrão é False, indicando que as sessões de IM internas não serão arquivadas.

Description

Opcional

Cadeia de caracteres

Permite aos administradores fornecer texto adicional em relação à política. Por exemplo, a propriedade Descrição pode ser usada para detalhar a quais usuários a política deverá se aplicar.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir ao se executar o comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy. Remove-CsArchivingPolicy aceita entradas canalizadas de objetos da política de arquivamento.

Tipos de Retorno

Set-CsArchivingPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy.

Exemplo

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

Set-CsArchivingPolicy -Identity global -ArchiveInternal $True

Neste exemplo, Set-CsArchivingPolicy é usado para modificar a política de arquivamento global. Neste caso, a propriedade ArchiveInternal é definida como sendo True.

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

Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True

O Exemplo 2 é uma variação do comando exibido no Exemplo 1. Desta vez, entretanto, todas as políticas de arquivamento na organização são configuradas de modo a permitir o arquivamento de sessões de IM. Para obter esse resultado, o comando usa primeiro Get-CsArchivingPolicy para retornar uma coleção de todas as políticas de arquivamento de sessões de IM em uso. Esta coleção é então canalizada ao Set-CsArchivingPolicy, que define a propriedade ArchiveInternal de cada política como True.