Get-CsArchivingConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur la manière dont vos sessions de messagerie instantanée sont archivées dans votre organisation, le cas échéant.
Syntaxe
Get-CsArchivingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsArchivingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Bon nombre d’organisations considèrent qu’il est utile de transcrire tous les sessions de messagerie instantanée auxquelles participent leurs utilisateurs, ou certains seulement. Pour d’autres organisations, il est obligatoire de garder ces transcriptions. Par exemple, de nombreuses organisations dans le monde financier sont légalement tenues de conserver des copies de toutes leurs communications électroniques.
Microsoft Lync Server 2010 vous offre cette flexibilité lorsqu’il s’agit d’archiver des sessions de conférences Web et de messagerie instantanée. Si vous avez déployé serveur d’archivage, vous pouvez utiliser les diverses cmdlets 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 en cas d’échec de l’archivage ; cela permet de garantir la tenue d’un registre de toutes vos communications électroniques.
Afin d’archiver les sessions de messagerie instantanée, vous devez configurer au moins un serveur d’archivage. Après que le serveur d’archivage configuré, vous devez effectuer deux étapes supplémentaires. Tout d’abord, vous devez activer l’archivage au niveau de l’étendue appropriée (pour plus de détails, voir la rubrique Set-CsArchivingConfiguration). Ce peut être l’étendue globale ; toutefois, vous pouvez également configurer des paramètres d’archivage personnalisés pour différents sites.
Ensuite, vous devez utiliser des stratégies d’archivage pour indiquer quels utilisateurs sont concernés par l’archivage de leurs sessions de messagerie instantanée. Que se passe-t-il si vous activez l’archivage sans attribuer aux utilisateurs une stratégie qui spécifie que leurs sessions de messagerie instantanée doivent être archivées ? En réalité, rien ne se passe : les sessions de messagerie instantanée ne seront pas archivées à moins qu’une stratégie en vigueur nécessite l’archivage des sessions de messagerie instantanée.
Avec la cmdlet Get-CsArchivingConfiguration, vous pouvez déterminer comment l’archivage des sessions de messagerie instantanée a été configuré dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsArchivingConfiguration : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet 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 "Get-CsArchivingConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Indique l’identificateur unique pour la collection des paramètres d’archivage à retourner. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. Si vous souhaitez utiliser des caractères génériques, ajoutez plutôt le paramètre Filter. Si ce paramètre n’est pas spécifié, Get-CsArchivingConfiguration retournera une collection de tous les paramètres de configuration d’archivage utilisés dans l’organisation. |
Filter |
Facultatif |
Chaîne |
Vous permet d’utiliser des caractères génériques pour retourner une ou plusieurs collections de paramètres de configuration d’archivage. Pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Site, utilisez cette syntaxe : -Filter site:*. Pour retourner une collection de tous les paramètres qui ont la valeur de chaîne « Canada » dans leur identité (la seule propriété que vous pouvez filtrer), utilisez cette syntaxe : -Filter "*Canada*". |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les données de configuration d’archivage à partir du réplica local du magasin central de gestion et non depuis le magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsArchivingConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsArchivingConfiguration retourne les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsArchivingConfiguration
La commande présentée dans l’exemple 1 retourne une collection de tous les paramètres de configuration d’archivage utilisés dans votre organisation.
-------------------------- Exemple 2 --------------------------
Get-CsArchivingConfiguration -Identity site:Redmond
Dans l’exemple précédent, le paramètre Identity sert à limiter la collection retournée de paramètres de configuration d’archivage aux paramètres dont l’identité est site:Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsArchivingConfiguration -Filter site:*
Dans l’exemple 3, le paramètre Filter sert à limiter la collection retournée de paramètres de configuration d’archivage aux paramètres qui ont été configurés au niveau de l’étendue Site. La valeur de paramètre site:* limite les éléments retournés à ceux dont l’identité commence par la valeur de chaîne « site: ».
-------------------------- Exemple 4 --------------------------
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -ne "None"}
Cet exemple utilise Get-CsArchivingConfiguration pour retourner une collection de tous les paramètres de configuration d’archivage dont l’utilisation a été activée dans votre organisation. Pour cela, la commande appelle d’abord Get-CsArchivingConfiguration sans paramètre afin de retourner une collection de tous vos paramètres de configuration d’archivage. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Celle-ci applique un filtre qui limite les données retournées aux collections dont la propriété EnableArchiving est différente de « None ». Si EnableArchiving est défini sur « None », l’archivage a été désactivé. Si cette propriété est définie sur toute autre valeur (« IMOnly » ou « ImAndWebConf »), cela signifie que l’archivage a été activé.
Voir aussi
Autres ressources
New-CsArchivingConfiguration
Remove-CsArchivingConfiguration
Set-CsArchivingConfiguration
Set-CsArchivingServer