Compartilhar via

  • Artigo

New-CsArchivingPolicy

 

Tópico modificado em: 2012-03-23

Cria novas políticas de arquivamento de sessões de IM. Essas políticas permitem arquivar sessões de IM que ocorrerem entre usuários internos e/ou arquivar sessões de IM que ocorrerem entre usuários internos e externos.

Sintaxe

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

Descrição Detalhada

Muitas organizações consideram útil 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 o Microsoft Lync Server 2010, devem-se executar duas etapas. Primeiramente, é necessário ativar o arquivamento no escopo de site e/ou global, utilizando-se o cmdlet Set-CsArchivingConfiguration. Isso permite arquivar sessões de IM, porém não inicia automaticamente o arquivamento dessas sessões.

Em vez disso, para salvar as transcrições das sessões de IM, deve-se concluir a segunda etapa: crie uma ou mais políticas de arquivamento de sessões de IM que determinam quais usuários terão suas sessões de IM registradas, bem como o tipo de sessão de 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.

As políticas de arquivamento podem ser atribuídas no escopo global ou de site. Além disso, essas políticas podem ser atribuídas no escopo por usuário e, em seguida, aplicadas a um usuário específico ou a um conjunto específico de usuários. Por exemplo: suponha que a política global arquive apenas as sessões de IM internas de todos os seus usuários. Neste caso, será 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. 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) só serão arquivadas.

É possível criar novas políticas de arquivamento (no escopo de site ou por usuário) utilizando-se o cmdlet New-CsArchivingPolicy. Se se criar uma política no escopo do site, ela será aplicada automaticamente ao site no momento em que for criada. Se se criar uma política no escopo por usuário, essa política não será usada enquanto ela não for atribuída explicitamente a um usuário ou conjunto de usuários, chamando-se o cmdlet Grant-CsArchivingPolicy. Não é possível criar uma nova política no escopo global.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Indica a Identidade exclusiva a ser atribuída à política. É possível criar novas políticas de arquivamento no escopo de site ou por usuário. Para criar uma nova política de site, utilize o prefixo "site:" seguido do nome do site. Por exemplo: esta sintaxe cria uma nova política para o site de Redmond: -Identity site:Redmond. Para criar uma nova política por usuário, use uma Identidade semelhante a esta: -Identity SalesArchivingPolicy.

Observe que não é possível criar uma nova política global; se desejar fazer alterações à política global, use o cmdlet Set-CsArchivingPolicy. Da mesma maneira, não é possível criar uma nova política de site ou por usuário, se já existir uma política com essa Identidade.

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 uma breve descrição da política de arquivamento. Por exemplo, a 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 ocorrer durante a execução do comando.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

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

Tipos de Retorno

New-CsArchivingPolicy cria instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy.

Exemplo

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

New-CsArchivingPolicy -Identity site:Redmond -ArchiveInternal $True

No Exemplo 1, o cmdlet New-CsArchivingPolicy é usado para criar uma nova política de arquivamento com a Identidade site:Redmond. Além disso, o parâmetro ArchiveInternal é definido como True. Isso significa que essa nova política permitirá o arquivamento de sessões de IM internas e conferências.

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

$x = New-CsArchivingPolicy -Identity site:Redmond -InMemory
$x.ArchiveInternal = $True
$x.ArchiveExternal = $True
Set-CsArchivingPolicy -Instance $x

O Exemplo 2 usa o parâmetro InMemory para criar uma política de arquivamento que inicialmente existirá apenas na memória. Nesse conjunto de comandos, New-CsArchivingPolicy é primeiramente chamado juntamente com o parâmetro InMemory, para criar uma nova política de site com a Identidade site:Redmond. Essa nova política apenas na memória será armazenada na variável $x. Nos comandos 2 e 3, modificam-se os valores de propriedade dessa política virtual; no comando 2, o valor da propriedade ArchiveInternal é definido como True e no comando 3, a propriedade ArchiveExternal é definida como True.

Finalmente, o último comando no exemplo usa Set-CsArchivingPolicy para transformar a política virtual site:Redmond em uma política real de arquivamento de sessões de IM.