• Artigo

Remove-CsArchivingPolicy

 

Tópico modificado em: 2012-03-27

Remove a diretiva de arquivamento de IM (mensagens instantâneas) especificada. As diretivas de arquivamento de IM determinam se o Lync Server salvará automaticamente todas as sessões de IM ocorridas entre usuários internos, e/ou todas as sessões de IM entre usuários internos e parceiros federados. UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)

Sintaxe

Remove-CsArchivingPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Exemplos

EXEMPLO 1

No Exemplo 1, o cmdlet Remove-CsArchivingPolicy é usado para excluir a diretiva com a Identity site:Redmond. Observe que quando uma diretiva configurada em escopo de site é excluída, os usuários que eram gerenciados pela diretiva de site passarão a ser governados automaticamente pela diretiva de arquivamento global.

Remove-CsArchivingPolicy -Identity site:Redmond

EXEMPLO 2

No Exemplo 2, todas as diretivas de arquivamento que tenham sido configuradas no escopo de site serão removidas. Isso é feito com o cmdlet Get-CsArchivingPolicy e com o parâmetro Filter para recuperar uma coleção de todas as diretivas de arquivamento atribuídas no escopo de site. Isso é feito com o valor de filtro "site:*", que instrui o cmdlet Get-CsArchivingPolicy a retornar somente as diretivas que tenham Identidade começando com o valor de cadeia de caracteres "site:". Depois que a coleção é retornada, os dados são canalizados para o cmdlet Remove-CsArchivingPolicy, que exclui todas as diretivas da coleção.

Get-CsArchivingPolicy -Filter site:* | Remove-CsArchivingPolicy

EXEMPLO 3

O Exemplo 3 exclui todas as diretivas de arquivamento nas quais a propriedade ArchiveExternal esteja definida como False. Para isso, o cmdlet Get-CsArchivingPolicy é usado primeiro para retornar uma coleção de todas as diretivas de arquivamento configuradas para em uso na organização. Essa coleção é então canalizada para o cmdlet Where-Object, que seleciona as diretivas nas quais a propriedade ArchiveExternal seja igual a False. A coleção filtrada é passada em seguida para o cmdlet Remove-CsArchivingPolicy, que exclui todas as diretivas na coleção.

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

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 Lync Server, é 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. Essas políticas determinam quais usuários terão suas sessões de IM gravadas, além dos 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 políticas de arquivamento podem ser atribuídas ao escopo global ou ao escopo de site. Além disso, essas políticas podem ser atribuídas ao escopo por usuário e aplicadas a um usuário específico, ou a um conjunto de usuários. Por exemplo, suponha que sua política global arquive apenas sessões de IM internas de todos os seus usuários. Nesse caso, você pode criar uma segunda política que arquive tanto sessões internas quanto externas e aplicar essa política apenas à sua equipe de vendas. Como as políticas por usuário têm precedência sobre as políticas 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 façam parte do departamento de vendas e que portanto não são afetados pela política de vendas) só terão suas sessões de IM internas arquivadas.

O cmdlet Remove-CsArchivingPolicy permite a exclusão de uma diretiva de arquivamento que tenha sido criada para uso em sua organização. Se uma diretiva por usuário for excluída, todos os usuários que tenham sido atribuídos a essa diretiva estarão automaticamente sob a jurisdição da diretiva de site relevante. Se não houver diretiva de site, esses usuários serão governados pela diretiva global. Se uma diretiva de site for removida, os usuários afetados pela diretiva estarão automaticamente sob a jurisdição da diretiva global.

Observe que é possível usar o cmdlet Remove-CsArchivingPolicy na diretiva global, mas que a diretiva global não pode ser removida. Em vez disso, a execução do cmdlet Remove-CsArchivingPolicy na diretiva global fará com que todas as propriedades dessa diretiva sejam redefinidas para seus valores padrão, ou seja, nem as sessões internas de IM nem as externas serão arquivadas. Isso acontece porque o valor padrão para as duas propriedades (ArchiveInternal e ArchiveExternal) é False.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Microsoft.Rtc.Management.Xds.XdsIdentity

Identificador único para a diretiva de arquivamento a ser removida. As diretivas de arquivamento podem ser configuradas em escopo global, de site ou por usuário. Para remover a diretiva global, use esta sintaxe: -Identity global. (Observe que a diretiva global não pode realmente ser removida. Em vez disso, todas as propriedades da diretiva serão redefinidas para seus valores padrão.)

Para remover uma diretiva de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para remover uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity SalesArchivingPolicy.

Curingas não podem ser usados para especificar uma Identity.

Confirm

Opcional

System.Management.Automation.SwitchParameter

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

Force

Opcional

System.Management.Automation.SwitchParameter

Se este parâmetro estiver presente, a diretiva será removida automaticamente mesmo que esteja atribuída no momento a pelo menos um usuário. Se não estiver presente, o cmdlet Remove-CsArchivingPolicy não removerá automaticamente uma diretiva por usuário que esteja atribuída a pelo menos um usuário. Em vez disso, um prompt de confirmação será exibido perguntando se você tem certeza de que deseja remover a diretiva. Responda sim (pressionando a tecla S) para que o comando prossiga e a diretiva seja removida.

Tenant

Opcional

System.Guid

PARAMVALUE: Guid

WhatIf

Optional

System.Management.Automation.SwitchParameter

GUID (identificador global exclusivo) da conta de locatário do Office 365 que possui a rega de política de arquivamento sendo removida. Por exemplo:

–Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Você pode retornar a ID do locatário para cada um dos locatários executando este comando:

Get-CsTenant | Select-Object DisplayName, TenantID

Se você estiver usando uma sessão remota do Windows PowerShell e estiver conectado somente ao Lync Online 15 não terá que incluir o parâmetro Tenant. Em vez disso, a ID do locatário será preenchida automaticamente para você com base nas suas informações de conexão. O parâmetro Tenant destina-se basicamente ao uso em um ambiente híbrido.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy. O cmdlet Remove-CsArchivingPolicy aceita entrada em pipeline dos objetos de diretiva de arquivamento.

Tipos de Retorno

O cmdlet Remove-CsArchivingPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.