Partager via

  • Article

Get-CsArchivingPolicy

 

Dernière rubrique modifiée : 2012-03-23

Retourne des informations sur vos stratégies d’archivage des sessions de messagerie instantanée. Les stratégies d’archivage vous permettent d’archiver les sessions de messagerie instantanée et de conférence Web qui ont lieu entre les utilisateurs internes et/ou entre les utilisateurs internes et les utilisateurs externes.

Syntaxe

Get-CsArchivingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsArchivingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Bon nombre d’organisations considèrent qu’il est utile d’archiver les sessions de messagerie instantanée auxquelles leurs utilisateurs participent ; d’autres y sont obligées par la loi. Pour archiver les sessions de messagerie instantanée avec Microsoft Lync Server 2010, il vous faut effectuer deux démarches. Tout d’abord, vous devez activer l’archivage au niveau de l’étendue globale et/ou de l’étendue Site, à l’aide de la cmdlet Set-CsArchivingConfiguration. Cela vous permet d’archiver les sessions de messagerie instantanée, mais l’archivage de ces sessions ne commence pas automatiquement pour autant.

Par conséquent, pour enregistrer les transcriptions de vos sessions de messagerie instantanée, vous devez procéder à l’étape 2 : créer une ou plusieurs stratégies d’archivage des sessions de messagerie instantanée. Ces stratégies déterminent pour quels utilisateurs les sessions de messagerie instantanée seront enregistrées et quels types de sessions (internes et/ou externes) seront archivés. Les sessions de messagerie instantanée internes sont les sessions dans lesquelles l’ensemble des participants sont des utilisateurs authentifiés disposant de comptes Active Directory au sein de votre organisation ; les sessions de messagerie instantanée externes sont les sessions dans lesquelles au moins un participant est un utilisateur non authentifié qui ne dispose pas d’un compte Active Directory de votre organisation. Vous pouvez choisir d’archiver les sessions internes uniquement, les sessions externes uniquement ou les sessions internes et externes.

Les stratégies d’archivage (créées à l’aide de la cmdlet New-CsArchivingPolicy) peuvent être attribuées au niveau de l’étendue globale ou de l’étendue Site. De plus, ces stratégies peuvent être attribuées au niveau de l’étendue Utilisateur ; cela signifie qu’une stratégie peut être créée, puis appliquée à un utilisateur ou à un jeu d’utilisateurs spécifique. Par exemple, vous pouvez avoir une stratégie globale qui archive les sessions de messagerie instantanée internes pour tous les utilisateurs. En outre, vous pouvez créer une deuxième stratégie qui archive les sessions internes et externes, puis l’appliquer à votre équipe commerciale. Parce que les stratégies utilisateur sont prioritaires sur les stratégies globales et de site, les membres de l’équipe commerciale verront toutes leurs sessions de messagerie instantanée archivées. Les autres utilisateurs (à savoir les personnes étrangères au service commercial et non concernées par la stratégie adoptée par ce service) verront uniquement leurs sessions internes de messagerie instantanée archivées.

La cmdlet Get-CsArchivingPolicy vous permet de retourner les informations concernant les stratégies d’archivage qui ont été configurées pour votre organisation. N'oubliez pas que ces stratégies ne sont appliquées que si l’archivage des sessions de messagerie instantanée a été activé au niveau de l’étendue globale ou de l’étendue Site. Pour savoir si l’archivage des sessions de messagerie instantanée est activé, utilisez la cmdlet Get-CsArchivingConfiguration.

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-CsArchivingPolicy : 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-CsArchivingPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie d'archivage à retourner. Pour faire référence à la stratégie globale, utilisez la syntaxe suivante : -Identity global. Pour faire référence à une stratégie du site, utilisez une syntaxe de type : -Identity site:Redmond. Pour faire référence à une stratégie par utilisateur, utilisez une syntaxe de type : -Identity RedmondArchivingPolicy. Si ce paramètre est omis, toutes les stratégies d’archivage configurées pour votre organisation seront retournées.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lors de la spécification des stratégies à retourner. Par exemple, pour retourner toutes les stratégies configurées au niveau du site, utilisez la syntaxe suivante : -Filter "site:*". Elle renvoie une stratégie dont la propriété Identity (la seule sur laquelle le filtrage peut être basé) commence par la valeur de chaîne « site: ». Pour retourner une collection de toutes les stratégies par utilisateur dont une propriété Identity commence par « Sales », utilisez la syntaxe suivante : -Filter "Sales*".

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de stratégie d'archivage à partir du réplica local du magasin central de gestion et non du magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsArchivingPolicy n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsArchivingPolicy retourne des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsArchivingPolicy

L'exemple 1 appelle Get-CsArchivingPolicy sans aucun paramètre. Il retourne une collection de toutes les stratégies d’archivage actuellement utilisées dans votre organisation.

-------------------------- Exemple 2 --------------------------

Get-CsArchivingPolicy -Identity site:Redmond

Dans l’exemple 2, Get-CsArchivingPolicy est utilisée pour retourner la stratégie d’archivage avec la propriété Identity site:Redmond. Parce que les identités doivent être uniques, cette commande retournera toujours, au mieux, une seule stratégie.

-------------------------- Exemple 3 --------------------------

Get-CsArchivingPolicy -Filter tag:*

La commande ci-dessus retourne une collection de toutes les stratégies d’archivage qui ont été configurées au niveau de l’étendue Utilisateur. Pour cela, il faut inclure le paramètre Filter et la valeur de filtre « tag:* ». Cette valeur de filtre indique à Get-CsArchivingPolicy de retourner uniquement les stratégies dont la propriété Identity commence par « tag: ».

-------------------------- Exemple 4 --------------------------

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

L’exemple 4 retourne une collection de toutes les stratégies d’archivage dans lesquelles l’archivage des sessions de messagerie instantanée internes a été désactivé. Pour cela, Get-CsArchivingPolicy est d’abord utilisée pour retourner une collection de toutes les stratégies d’archivage actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Ensuite, Where-Object applique un filtre qui restreint les données retournées aux stratégies dans lesquelles la valeur de la propriété ArchiveInternal est égale à False.

-------------------------- Exemple 5 --------------------------

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

L’exemple 5 ressemble à l’exemple 4 ; dans ce cas, toutefois, la commande retourne toutes les stratégies d’archivage dans lesquelles l’archivage des sessions internes et externes est désactivé. Pour cela, Get-CsArchivingPolicy est d’abord utilisée pour retourner une collection de toutes les stratégies d’archivage actuellement utilisées. Cette collection est ensuite redirigée vers Where-Object qui retourne les stratégies dans lesquelles les propriétés ArchiveInternal et ArchiveExternal sont égales à False. L’opérateur -and indique à Where-Object de sélectionner uniquement les stratégies qui répondent à tous les critères spécifiés. Pour sélectionner des stratégies qui répondent à un seul (ou deux) des critères spécifiés, utilisez l'opérateur –or :

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}