Export-CsArchivingData
Dernière rubrique modifiée : 2012-10-17
Permet d’exporter des enregistrements qui ont été stockés dans la base de données d’archivage de Microsoft Lync Server 2010.
Syntaxe
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>]]
Description détaillée
Bon nombre d’organisations jugent utile de conserver une transcription de toutes les sessions de messagerie instantanée auxquelles leurs utilisateurs ont pris part. Pour d’autres organisations, il est obligatoire de garder ces transcriptions. Par exemple, certaines organisations dans le monde financier sont souvent légalement tenues de conserver des copies de toutes leurs communications électroniques.
Quel que soit le motif, Lync Server 2010 est flexible quand il s’agit d’archiver des messages instantanés et des sessions de conférence. Si vous avez déployé serveur d’archivage, vous pouvez utiliser les diverses applets de commande CsArchivingConfiguration pour activer et désactiver l’archivage des sessions de messagerie instantanée et gérer votre base de données d’archivage. Vous pouvez également suspendre la messagerie instantanée si l’archivage ne répond pas, ce qui vous permet de conserver un enregistrement de toutes les communications électroniques.
Si vous avez activé l’archivage, les enregistrements des communications électroniques de vos utilisateurs sont archivés dans la base de données d’archivage. Si vous souhaitez consulter ces enregistrements (ou un sous-ensemble choisi), vous pouvez utiliser l’applet de commande Export-CsArchivingData pour extraire ces enregistrements de la base de données et les enregistrer dans un fichier Outlook Express .EML (Electronic Mail).
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande Export-CsArchivingData : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette applet de commande a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Export-CsArchivingData"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
DBInstance |
Obligatoire |
Chaîne |
Chemin d’accès à l’instance de base de données SQL Server dans laquelle les données d’archivage sont enregistrées. Par exemple : "atl-sql-001\Archinst". |
OutputFolder |
Obligatoire |
Chaîne |
Chemin d’accès complet au dossier où les données exportées doivent être enregistrées (par exemple, C:\ArchivingExports). Si ce dossier n’existe pas, alors Export-CsArchivingData le créera. |
StartDate |
Obligatoire |
DateTime |
Indique la date d’activité la plus proche pour les enregistrements à exporter. Par exemple, si vous définissez la date de début au 1/6/2010 (June 1, 2010, en anglais américain), tous les éléments enregistrés dans la base de données avant cette date (par exemple, les éléments enregistrés le 31 mai 2010) seront exclus de l’exportation. Utilisez les formats de date et heure spécifiés par les paramètres de vos options régionales et linguistiques lors de l’affectation des valeurs aux propriétés StartDate et EndDate. |
EndDate |
Facultatif |
DateTime |
Indique la date d’activité la plus tardive pour les enregistrements à exporter. Par exemple, si vous définissez la date de fin au 1/6/2010 (June 1, 2010, en anglais américain), tous les éléments enregistrés dans la base de données après cette date (par exemple, les éléments enregistrés le 2 juin 2010) seront exclus de l’exportation. Bien que vous ne receviez pas de message d’erreur, votre exportation échoue si la date de fin est antérieure à la date de début (par exemple, une date de fin au 1/1/2010 et une date de début au 1/6/2010). Utilisez les formats de date et heure spécifiés par les paramètres de vos options régionales et linguistiques lors de l’affectation des valeurs aux propriétés StartDate et EndDate. Si la date de fin n’est pas spécifiée, alors c’est la date actuelle qui sera utilisée. |
UserUri |
Facultatif |
Chaîne |
Active les données d’archivage de l’exportation pour un utilisateur unique, ce qui est réalisé à l’aide du paramètre UserUri et en spécifiant l’adresse SIP de l’utilisateur. Le paramètre UserUri acceptera uniquement un URI à la fois. |
ExcludeWebConfArchive |
Facultatif |
Paramètre de commutateur |
Donne l’instruction à Export-CsArchivingData de n’exporter que les enregistrements de messages instantanés. Par défaut, l’applet de commande exporte à la fois les enregistrements de messages instantanés et de conférences. |
IncludeTrustedApplication |
Facultatif |
Paramètre de commutateur |
S’il est présent, ce paramètre indique à Export-CsArchivingData d’inclure les données journalisées par les applications approuvées lors de l’exportation d’enregistrements. |
Purge |
Facultatif |
Paramètre de commutateur |
Une fois inclus, le paramètre Purge force la suppression de tous les enregistrements exportés avec succès à partir de la base de données d’archivage. Si vous n’incluez pas ce paramètre, les enregistrements exportés seront conservés dans la base de données. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Export-CsArchivingData n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Export-CsArchivingData retourne les enregistrements de la base de données d’archivage au format EML.
Exemple
-------------------------- Exemple 1 --------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -OutputFolder "C:\ArchivingExports"
La commande indiquée dans l’exemple 1 extrait les enregistrements de la base de données d’archivage atl-sql-001\Archinst et enregistre le fichier EML obtenu dans le dossier C:\ArchivingExports. La date de début spécifiée au 1er janvier 2010 (-StartDate 1/1/2010) garantit que seuls les éléments enregistrés dans la base de données après le 31/12/2009 (un jour avant la date de début) seront exportés.
-------------------------- Exemple 2 --------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -OutputFolder "C:\ArchivingExports" -UserUri "kenmyer@litwareinc.com"
La commande précédente est une variante de la commande illustrée à l’exemple 1. Dans ce cas, cependant, seuls les enregistrements appartenant à l’utilisateur Ken Myer seront exportés. Pour limiter vos exportations aux enregistrements appartenant à un utilisateur unique, incluez le paramètre UserUri suivi de l’adresse SIP adéquate.
-------------------------- Exemple 3 --------------------------
Export-CsArchivingData -DBInstance atl-sql-001\Archinst -StartDate 1/1/2010 -EndDate 1/31/2010 -OutputFolder "C:\ArchivingExports"
L’exemple 3 représente une autre variante de la commande présentée dans l’exemple 1. Dans l’exemple 3, seuls les éléments enregistrés dans la base de données pendant le mois de janvier 2010 sont exportés. Pour limiter l’exportation à cet intervalle de temps, le paramètre EndDate est inclus avec le paramètre StartDate. Avec une date de début au 1er janvier 2010 et une date de fin au 31 janvier 2010, l’exportation est limitée aux éléments enregistrés pendant le mois de janvier 2010.