• Artigo

Remove-CsArchivingConfiguration

 

Tópico modificado em: 2012-03-27

Remove a coleção especificada de definições de arquivamento. As definições de arquivamento são usadas para habilitar ou desabilitar o salvamento automático de sessões de mensagem instantânea (IM) e bloquear opcionalmente qualquer mensagem instantânea que não possa ser arquivada.

Sintaxe

Remove-CsArchivingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Muitas organizações consideram útil manter uma transcrição de todas as sessões de mensagens instantâneas e conferências de que os usuários participam. Para outras organizações, é 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 sessões de IM, 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.

Ao se instalar o Lync Server 2010, será criada uma coleção de definições de arquivamento global; por padrão, essas definições se aplicarão a toda sua organização. Como alternativa, é possível usar o cmdlet New-CsArchivingConfiguration para criar definições de configuração personalizada com base nos sites específicos. Qualquer definição específica a um site que for criada usando-se New-CsArchivingConfiguration pode ser removida posteriormente usando-se o cmdlet Remove-CsArchivingConfiguration. Ao se remover as definições de um site, ele passará a ser governado pelas definições globais.

Observe que também é possível executar Remove-CsArchivingConfiguration concomitantemente às definições de arquivamento globais. No entanto, nesse caso, as definições não serão removidas porque as definições globais não podem ser excluídas. Em vez disso, todas as propriedades globais serão redefinidas com os seus valores padrão. Por exemplo, suponhamos que se tenha habilitado o arquivamento de sessões de IM no escopo global; posteriormente, será possível executar o comando Remove-CsArchivingConfiguration -Identity global. A execução desse comando redefinirá os valores da propriedade com as definições globais; isso significa que EnableArchiving reverterá ao seu valor padrão None. Por sua vez, isso desabilitará o arquivamento no escopo global.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de arquivamento a ser removida. Para remover a coleção global, use a seguinte sintaxe: -Identity global (observe que não é possível remover efetivamente as definições globais; em vez disso, pode-se apenas redefinir as propriedades com os seus valores padrão.) Para remover uma coleção de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Não é possível usar curingas ao se especificar uma política Identity.

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.

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.Settings.Archiving.ArchivingSettings. Remove-CsArchivingConfiguration aceita entradas canalizadas de objetos de configuração de arquivamento.

Tipos de Retorno

Set-CsArchivingConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.

Exemplo

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

Remove-CsArchivingConfiguration -Identity site:Redmond

O exemplo anterior usa Remove-CsArchivingConfiguration para excluir as definições de configuração de arquivamento cuja Identidade for site:Redmond.

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

Get-CsArchivingConfiguration -Filter "site:*" | Remove-CsArchivingConfiguration

O comando exibido no Exemplo 2 remove todas as definições de configuração de arquivamento que tiverem sido configuradas no escopo de site. Para fazer isso, o comando primeiramente usa Get-CsArchivingConfiguration e o parâmetro Filter, para retornar uma coleção de todas as definições configuradas no escopo de site. Isso é feito usando-se o valor de filtro "site:*", que limita os dados retornados a definições que possuírem uma Identidade iniciada pelos caracteres "site:". A coleção filtrada será então canalizada para Remove-CsArchivingConfiguration, que excluirá cada item na coleção.

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

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

O Exemplo 3 exclui todas as definições de configuração de arquivamento cuja propriedade EnableArchiving tiver sido definida como "None". Para realizar essa tarefa, chama-se Get-CsArchivingConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as definições de arquivamento configuradas para uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições nas quais a propriedade EnableArchiving for igual a "None". A coleção filtrada será então canalizada para Remove-CsArchivingConfiguration, que excluirá cada item na coleção.