Compartilhar via

  • Artigo

Grant-CsArchivingPolicy

 

Tópico modificado em: 2012-03-23

Permite atribuir políticas de arquivamento de sessões de mensagens instantâneas (IM) a usuários ou grupos de usuários. 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

Grant-CsArchivingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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.

Para salvar as transcrições das sessões de IM, deve-se concluir a segunda etapa: criar 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 registradas, bem como o tipo de sessão de IM (interna e/ou externa) que será arquivado. As sessões de IM internas são aquelas nas quais todos os participantes são usuários autenticados e com contas no Active Directory da organização. Por outro lado, as sessões de IM externas são aquelas nas quais pelo menos um dos participantes é um usuário não-autenticado, sem uma conta no Active Directory da 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 somente as sessões de IM internas. 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. 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 Grant-CsArchivingPolicy é utilizado para atribuir políticas de arquivamento por usuário a um usuário ou a um grupo especificado de usuários.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Indica a identidade da conta do usuário à qual será atribuída a política. As identidades de usuário podem ser especificadas usando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer) e 4) o nome de exibição dos Serviços de Domínio no Active Directory do usuário (por exemplo, Ken Myer). Também é possível fazer referência às Identidades de usuário, usando-se o nome diferenciado do usuário no Active Directory.

Além disso, é possível utilizar o caractere curinga asterisco (*) ao utilizar o nome de exibição como identidade do usuário. Por exemplo, a identidade "* Smith" retornará todos os usuários com nome de exibição que terminarem com o valor da cadeia de caracteres " Smith".

PolicyName

Obrigatório

Cadeia de caracteres

"Nome" da política a ser atribuída. PolicyName é simplesmente a identidade de política sem o designador de escopo "tag:". Por exemplo, uma política cuja identidade for tag:Redmond possui um PolicyName igual a Redmond; uma política cuja identidade for tag:RedmondArchivingPolicy possui um PolicyName igual a RedmondArchivingPolicy.

Para remover uma política por usuário que tenha sido atribuída a um usuário, defina PolicyName como um valor nulo:

-PolicyName $Null

DomainController

Opcional

Cadeia de caracteres

Permite especificar um controlador de domínio para se conectar ao atribuir a política. Se o parâmetro não for incluído, o cmdlet usará o primeiro controlador de domínio disponível.

PassThru

Opcional

Parâmetro de opção

Se houver, o cmdlet canalizará o objeto (ou objetos) do usuário através do Windows PowerShell. Por padrão, o Grant-CsArchivingPolicy não canaliza objetos.

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

Valor da cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsArchivingPolicy aceita entradas canalizadas de valores de cadeia de caracteres que representam a Identidade de uma conta de usuário. O cmdlet também aceita entradas canalizadas de objetos de usuário.

Tipos de Retorno

Grant-CsArchivingPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet atribui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy a usuários ou grupos de usuários. No entanto, se o parâmetro PassThru for incluído, o cmdlet retornará instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemplo

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

Grant-CsArchivingPolicy -Identity "Ken Myer" -PolicyName RedmondArchivingPolicy

No Exemplo 1, a política de arquivamento RedmondArchivingPolicy é atribuída ao usuário com o nome de exibição "Ken Myer". Observe que, no caso do Grant-CsArchivingPolicy, a propriedade Identity se refere à identidade do usuário, e não a identidade da política de arquivamento. Em vez disso, a política a ser atribuída é especificada utilizando-se o parâmetro PolicyName; o valor de parâmetro é a identidade de política (sem o prefixo "tag:").

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

No comando anterior, a política de arquivamento RedmondArchivingPolicy foi atribuída a todos os usuários com contas na unidade organizacional (OU) Redmond. Para fazer isso, Get-CsUser e o parâmetro OU são utilizados, para retornar uma coleção de todos os usuários que tiverem contas na OU com o nome distinto "OU=Redmond,dc=litwareinc,dc=com". Esta coleção será então canalizada para Grant-CsArchivingPolicy, que atribuirá a política RedmondArchivingPolicy a cada usuário na coleção.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

O comando apresentado no Exemplo 3 atribui a política RedmondArchivingPolicy a todos os usuários que trabalharem em Redmond. Para realizar esta tarefa, chama-se Get-CsUser, juntamente com o parâmetro LdapFilter. O valor de filtro LDAP "l=Redmond" retorna uma coleção de todos os usuários que trabalharem na cidade de Redmond. (na linguagem de consultas LDAP, "l", um L minúsculo, é uma abreviação de "localidade" ou cidade). Esta coleção será então canalizada para Grant-CsArchivingPolicy, que atribuirá a política RedmondArchivingPolicy a cada usuário na coleção.

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

Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

No Exemplo 4, a política RedmondArchivingPolicy será atribuída a todos os usuários que pertencerem ao pool Registrador atl-cs-001.litwareinc.com. Para isso, utiliza-se primeiramente Get-CsUser, para retornar todos os usuários que tiverem sido habilitados para o Lync Server. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os usuários cujo RegistrarPool for igual a atl-cs-001-litwareinc.com. Esta coleção filtrada será então canalizada para Grant-CsArchivingPolicy, que atribuirá a política RedmondArchivingPolicy a cada usuário na coleção.

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

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName "NorthAmericaArchivingPolicy"

O Exemplo 5 localiza todos os usuários aos quais tiver sido atribuída a política RedmondArchivingPolicy e, em seguida, atribui a cada um desses usuários uma política diferente: NorthAmericaArchivingPolicy. Para realizar essa tarefa, utiliza-se Get-CsUser, para retornar uma coleção de todos os usuários que tiverem sido habilitados para o Lync Server. O parâmetro Filter e o valor de filtro {ArchivingPolicy -eq "RedmondArchivingPolicy"} limitam os dados retornados às contas nas quais ArchivingPolicy for igual a "RedmondArchivingPolicy". Esta coleção filtrada será então canalizada para Grant-CsArchivingPolicy, que atribuirá a política NorthAmericaArchivingPolicy a cada usuário na coleção.

-------------------------- Exemplo 6 ------------------------

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName $Null

O Exemplo 6 é uma variação do Exemplo 5. Desta vez, entretanto, a atribuição da política RedmondArchivingPolicy é retirada de todos os usuários aos quais tiver sido previamente atribuída. O ato de chamar Grant-CsArchivingPolicy com PolicyName igual a $Null remove quaisquer políticas por usuário atribuídas previamente.