Partager via

  • Article

Grant-CsArchivingPolicy

 

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

Vous permet d’assigner des stratégies d’archivage de session de messagerie instantanée à des utilisateurs ou à un groupe d’utilisateurs. Ces stratégies vous donnent la possibilité d’archiver les sessions de messagerie instantanée qui ont lieu entre les utilisateurs internes, et/ou d’archiver toutes les sessions de messagerie instantanée qui ont lieu entre les utilisateurs internes et les partenaires extérieurs.

Syntaxe

Grant-CsArchivingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Bon nombre d’organisations trouvent utile de converser des archives de toutes les sessions de messagerie instantanée auxquelles les utilisateurs prennent part. D’autres organisation sont tenues par la loir de conserver ces archives. Pour archiver les sessions de messagerie instantanée avec Microsoft Lync Server 2010, il vous faut effectuer deux démarches. D’abord, vous devez activer l’archivage dans l’étendue globale et/ou du site en utilisant la cmdlet Set-CsArchivingConfiguration. Cela vous permet d’archiver les sessions de messagerie instantanée, sans que l'archivage de ces sessions soit automatique.

Pour effectivement enregistrer les transcriptions de vos sessions de messagerie instantanée, vous devez mener à bien l’étape 2 : créer une ou plusieurs stratégies d’archivage de session de messagerie instantanée. Ces stratégies déterminent quelles sessions seront enregistrées pour quels utilisateurs ainsi que le type de session de messagerie instantanée (interne et/ou externe) qui sera archivé. Les sessions de messagerie instantanée internes où tous les participants sont des utilisateurs authentifiés avec des comptes Active Directory dans votre organisation. En contraste, les sessions de messagerie instantanée externes sont des sessions pour lesquelles un participant est un utilisateur non authentifié qui ne possède pas de compte Active Directory dans votre organisation. Vous pouvez choisir de n’archiver que les sessions internes ou externes, ou les deux.

Les stratégies d’archivage peuvent être attribuées au niveau de l’étendue globale ou au niveau de l’étendue Site. De plus, ces stratégies peuvent être attribuées au niveau de l’étendue Utilisateur, puis appliquées à un utilisateur ou à un ensemble d’utilisateurs spécifique. Par exemple, supposons que votre stratégie globale archive uniquement les sessions de messagerie instantanée internes. Dans ce cas, vous pouvez créer une deuxième stratégie qui archive les sessions internes et externes, puis l’appliquer à votre équipe commerciale. Comme les stratégies Utilisateur sont prioritaires sur les stratégies globales et du 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 Grant-CsArchivingPolicy est utilisée pour affecter des stratégies d’archivage Utilisateur à un utilisateur ou un groupe d’utilisateurs spécifique.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Grant-CsArchivingPolicy : RTCUniversalUserAdmins. 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 "Grant-CsArchivingPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Indique l’identité du compte utilisateur auquel la stratégie doit être assignée. Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) l’adresse SIP de l’utilisateur, 2) le nom d’utilisateur principal (UPN), 3) le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Les identités utilisateur peuvent être référencées à l’aide d’un nom unique Active Directory.

En outre, vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » retourne tous les utilisateurs dont le nom complet se termine par la valeur « Smith ».

PolicyName

Obligatoire

Chaîne

« Nom » de la stratégie à assigner. Le nom PolicyName n’est qu’une identité de stratégie moins l’étiquette qui désigne l’étendue « tag: ». Par exemple, PolicyName, le nom de stratégie avec l’identité tag:Redmond est égal à Redmond. PolicyName de la stratégie avec l’identité tag:RedmondArchivingPolicy est égal à RedmondArchivingPolicy.

Pour supprimer une stratégie Utilisateur affectée à un utilisateur en particulier, définissez PolicyName sur une valeur nulle :

-PolicyName $Null

DomainController

Facultatif

Chaîne

Vous permet de spécifier un contrôleur de domaine auquel vous connecter quand vous assignez la stratégie. Si ce paramètre n’est pas inclus, la cmdlet utilisera le premier contrôleur de domaine disponible.

PassThru

Facultatif

Paramètre de commutateur

S’il est présent, la cmdlet transfère le ou les objets d’utilisateur via le pipeline Windows PowerShell. Par défaut, Grant-CsArchivingPolicy ne passe aucun objet via le pipeline.

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

Valeur de chaîne ou objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsArchivingPolicy accepte la saisie de données transmises via le pipeline de valeurs de chaîne qui représentent l'identité d'un compte d’utilisateur. La cmdlet accepte également la saisie de données transmises via le pipeline pour les objets utilisateur.

Types de retours

Grant-CsArchivingPolicy ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet affecte des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy à des utilisateurs ou groupes d'utilisateurs. Toutefois, si vous incluez le paramètre PassThru, la cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemple

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

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

Dans l’exemple 1, la stratégie d’archivage RedmondArchivingPolicy est assignée à l’utilisateur avec le nom complet « Ken Myer ». Notez qu’avec Grant-CsArchivingPolicy, la propriété de l’identité fait référence à l’identité de l’utilisateur, pas celle de la stratégie d’archivage. Au lieu de cela, on précise la stratégie à affecter à l’aide du paramètre PolicyName. La valeur de paramètre est l’identité de la stratégie (moins le préfixe « tag: »).

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

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

Dans la commande ci-dessus, la stratégie d’archivage Redmond ArchivingPolicy est assignée à tous les utilisateurs détenteurs de comptes dans l’unité d’organisation Redmond. Pour ce faire, Get-CsUser et le paramètre de l’unité d’organisation sont utilisés pour renvoyer la collection de tous les utilisateurs qui ont des comptes dans l’unité d’organisation avec le nom unique « OU=Redmond,dc=litwareinc,dc=com ». La collection est ensuite redirigée vers Grant-CsArchivingPolicy qui affecte à chaque utilisateur de la collection la stratégie RedmondArchivingPolicy.

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

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

La commande indiquée à l’exemple 3 affecte la stratégie RedmondArchivingPolicy à tous les utilisateurs qui travaillent à Redmond. Pour effectuer cette tâche, on appelle Get-CsUser avec le paramètre LdapFilter, la valeur de filtre LDAP « l=Redmond » retournant une collection de tous les utilisateurs qui travaillent dans la ville de Redmond. (Dans le langage de requête LDAP, I en minuscule est une abréviation de « locality », ou ville.) La collection est ensuite redirigée vers Grant-CsArchivingPolicy qui affecte à chaque utilisateur de la collection la stratégie RedmondArchivingPolicy.

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

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

Dans l’exemple 4, on affecte à tous les utilisateurs hébergés sur le Serveur d’inscriptions atl-cs-001.litwareinc.com une stratégie RedmondArchivingPolicy. Pour ce faire, on utilise d'abord Get-CsUser pour retourner tous les utilisateurs qui ont été activés pour Lync Server. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les utilisateurs dont RegistrarPool est égal à atl-cs-001-litwareinc.com. Cette collection filtrée est ensuite redirigée vers Grant-CsArchivingPolicy, qui affecte la stratégie RedmondArchivingPolicy à chaque utilisateur de la collection.

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

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

L’exemple 5 recherche tous les utilisateurs qui se sont vu affecter la stratégie RedmondArchivingPolicy et leur affecte ensuite une stratégie différente : NorthAmericaArchivingPolicy. Pour effectuer cette tâche, on utilise Get-CsUser pour retourner une collection de tous les utilisateurs activés pour Lync Server. Le paramètre Filter et la valeur de filtre {ArchivingPolicy -eq "RedmondArchivingPolicy"} restreignent les données retournées aux comptes pour lesquels ArchivingPolicy est égal à « RedmondArchivingPolicy ». La collection filtrée est ensuite acheminée à Grant-CsArchivingPolicy qui assigne à chaque utilisateur de la collection la stratégie NorthAmericaArchivingPolicy.

-------------------------- Exemple 6 ------------------------

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

L’exemple 6 est une variante de l’exemple 5. Cette fois, cependant, la stratégie RedmondArchivingPolicy n'est plus affectée aux utilisateurs auxquels cette stratégie était précédemment affectée. Appeler Grant-CsArchivingPolicy avec un nom de stratégie égal à $Null supprime toute stratégie Utilisateur précédemment affectée.