Export-CsArchivingData
Tópico modificado em: 2012-10-17
Permite exportar registros que tenham sido armazenados no Microsoft Lync Server 2010 Banco de dados de arquivamento.
Sintaxe
Export-CsArchivingData -DBInstance <String> -OutputFolder <String> -StartDate <DateTime> [-Confirm [<SwitchParameter>]] [-EndDate <DateTime>] [-IncludeTrustedApplication <SwitchParameter>] [-Purge <SwitchParameter>] [-UserUri <String>] [-WhatIf [<SwitchParameter>]]
Export-CsArchivingData -DBInstance <String> -OutputFolder <String> -StartDate <DateTime> [-Confirm [<SwitchParameter>]] [-EndDate <DateTime>] [-ExcludeWebConfArchive <SwitchParameter>] [-IncludeTrustedApplication <SwitchParameter>] [-UserUri <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Muitas organizações julgam útil manter uma transcrição de todas as sessões de mensagens instantâneas (IM) realizadas por seus usuários. Para outras organizações, é obrigatório manter essas transcrições. Por exemplo, a lei frequentemente exige que as organizações do mundo financeiro mantenham cópias de todas as suas comunicações eletrônicas.
Independentemente do motivo, o Lync Server 2010 proporciona flexibilidade para arquivar mensagens instantâneas e sessões de conferências. Se você tiver implantado o Servidor de Arquivamento, poderá utilizar diversos cmdlets CsArchivingConfiguration para habilitar e desabilitar o arquivamento de mensagens instantâneas e para gerenciar o Banco de dados de arquivamento. Também é possível suspender as IM em caso de falha do arquivamento, o que ajuda a garantir que você mantenha um registro de todas as comunicações eletrônicas.
Se o arquivamento tiver sido habilitado, os registros das comunicações eletrônicas dos usuários serão armazenados no Banco de dados de arquivamento. Se desejar visualizar todos esses registros (ou um subconjunto selecionado), é possível utilizar o cmdlet Export-CsArchivingData para extrai-los do banco de dados e salvá-los como um arquivo .EML do Correio Eletrônico Outlook Express.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Export-CsArchivingData 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 "Export-CsArchivingData"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
DBInstance |
Obrigatório |
Cadeia de caracteres |
Caminho até a instância do banco de dados do Servidor SQL na qual serão gravados os dados de arquivamento. Por exemplo: "atl-sql-001\Archinst". |
OutputFolder |
Obrigatório |
Cadeia de caracteres |
Caminho completo da pasta em que devem-se armazenar os dados exportados (por exemplo, C:\ArchivingExports). Se esta pasta não existir, Export-CsArchivingData a criará. |
StartDate |
Obrigatório |
DataHora |
Indica a data inicial de atividade dos registros a serem exportados. Por exemplo: se a data inicial for definida como 1/6/2010 (1º de junho de 2010), quaisquer itens registrados no banco de dados antes desta data (por exemplo, em 31 de maio de 2010) serão excluídos da exportação. Utilize os formatos de data e hora especificados pelas suas definições de Opções Regionais e de Idioma ao atribuir valores às propriedades StartDate e EndDate |
EndDate |
Opcional |
DataHora |
Indica a data final dos registros a serem exportados. Por exemplo: se a data final for definida como 1/6/2010 (1º de junho de 2010), quaisquer itens registrados no banco de dados após esta data (por exemplo, em 2 de junho de 2010) serão excluídos da exportação. Apesar de não se receber uma mensagem de erro, a exportação falhará se a data final ocorrer antes da inicial (por exemplo, data final 1/1/2010 e data inicial 1/6/2010). Utilize os formatos de data e hora especificados pelas suas definições de Opções Regionais e de Idioma ao atribuir valores às propriedades StartDate e EndDate Se não se especificar uma data final, será utilizada a data atual. |
UserUri |
Opcional |
Cadeia de caracteres |
Permite exportar dados de arquivamento relativos a um único usuário; isto é feito utilizando-se o parâmetro UserUri e especificando-se o endereço SIP do usuário. O parâmetro UserUri aceitará somente um URI por vez. |
ExcludeWebConfArchive |
Opcional |
Parâmetro de opção |
Instrui o Export-CsArchivingData a exportar somente os registros de mensagens instantâneas. Por padrão, o cmdlet exporta os registros de IM e de conferência. |
IncludeTrustedApplication |
Opcional |
Parâmetro de opção |
Quando incluído, instrui o Export-CsArchivingData a incluir os dados registrados por aplicativos confiáveis ao exportar os registros. |
Purge |
Opcional |
Parâmetro de opção |
Quando incluído, o parâmetro Purge excluirá do Banco de dados de arquivamento qualquer registro que tenha sido exportado com sucesso. Se este parâmetro não for incluído, os registros exportados serão mantidos no banco de dados. |
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. Export-CsArchivingData não aceita a entrada canalizada.
Tipos de Retorno
Export-CsArchivingData retorna registros do Banco de dados de arquivamento no formato EML.
Exemplo
-------------------------- Exemplo 1 ------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -OutputFolder "C:\ArchivingExports"
O comando apresentado no Exemplo 1 extrai registros do Banco de dados de arquivamento atl-sql-001\Archinst e salva o arquivo EML resultante na pasta C:\ArchivingExports. A data inicial especificada, 1º de janeiro de 2010 (-StartDate 1/1/2010), garante a exportação somente dos itens registrados no banco de dados após 31/12/2009.
-------------------------- Exemplo 2 ------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -OutputFolder "C:\ArchivingExports" -UserUri "kenmyer@litwareinc.com"
O comando anterior é uma variação do comando apresentado no Exemplo 1. Neste caso, entretanto, serão exportados somente os registros relativos ao usuário Ken. Para limitar a exportação aos registros relativos a um único usuário, inclua o parâmetro UserUri, seguido do endereço SIP apropriado.
-------------------------- Exemplo 3 ------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -EndDate 1/31/2010 -OutputFolder "C:\ArchivingExports"
O Exemplo 3 representa outra variação do comando apresentado no Exemplo 1. No Exemplo 3, entretanto, serão exportados somente os itens registrados no banco de dados durante o mês de janeiro de 2010. Para limitar a exportação a este intervalo de tempo, incluiu-se o parâmetro EndDate, juntamente com o parâmetro StartDate. Com a data inicial 1º de janeiro de 2010 e a data final 31 de janeiro de 2010, limitando a exportação aos itens registrados durante janeiro de 2010.