Partager via


Set-CsArchivingPolicy

 

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

Modifie une stratégie d’archivage de messagerie instantanée (IM) existante. Une stratégie d’archivage vous permet d’archiver toutes les sessions de messagerie instantanée et conférences qui se tiennent entre des utilisateurs internes. Vous pouvez également archiver des sessions organisées entre des utilisateurs internes et des partenaires fédérés.

Syntaxe

Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Description détaillée

De nombreuses organisations préfèrent conserver une archive de toutes les sessions de messagerie instantanée auxquelles leurs utilisateurs participent. D’autres sont juridiquement contraintes de conserver ce type d’archive. Pour archiver des sessions de messagerie instantanée avec Microsoft Lync Server 2010, vous devez effectuer deux opérations. 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.

Pour enregistrer des transcriptions de vos sessions de messagerie instantanée, vous devez effectuer la deuxième étape : créer une ou plusieurs stratégies d’archivage qui déterminent les utilisateurs dont les sessions de messagerie instantanée sont enregistrées, ainsi que le type de session de messagerie instantanée (interne et/ou externe) qui sera archivé. Les sessions de messagerie instantanée internes sont des sessions où tous les participants sont des utilisateurs authentifiés possédant des comptes Active Directory dans votre organisation. Les sessions de messagerie instantanée externes sont des sessions où au moins un participant est un utilisateur non authentifié ne disposant pas de compte Active Directory dans votre organisation. Vous pouvez, si vous le souhaitez, archiver exclusivement des sessions internes, des sessions externes ou les deux.

Vous pouvez affecter des stratégies d’archivage (créées à l’aide de la cmdlet New-CsArchivingPolicy) dans l’étendue globale ou Site. De plus, ces stratégies peuvent être assignées dans l’étendue utilisateur. Cela signifie que la stratégie peut être créée et ensuite appliquée à un utilisateur spécifique ou un groupe d’utilisateurs défini. Par exemple, vous pouvez créer une stratégie globale qui archive les sessions de messagerie instantanée internes pour tous vos 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 Set-CsArchivingPolicy vous permet de modifier les valeurs de propriété d’une des stratégies d’archivage de sessions de messagerie instantanée actuellement utilisées 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 Set-CsArchivingPolicy : 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 "Set-CsArchivingPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie d’archivage à modifier. Vous pouvez configurer des stratégies d’archivage dans les étendues globale, Site ou utilisateur. Pour modifier la stratégie globale, utilisez la syntaxe suivante : -Identity global. Pour modifier une stratégie de site, utilisez une syntaxe de type : -Identity site:Redmond. Pour modifier une stratégie utilisateur, utilisez une syntaxe similaire à celle-ci : -Identity SalesArchivingPolicy. Si ce paramètre n’est pas spécifié, la stratégie globale sera modifiée.

Les caractères génériques ne sont pas autorisés pour spécifier une identité.

Instance

Facultatif

Objet IMArchivingPolicy

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

ArchiveExternal

Facultatif

Booléen

Indique si les sessions de messagerie instantanée externes sont archivées (une session de messagerie instantanée externe est une session où au moins l’un des participants est un utilisateur non authentifié ne possédant pas de compte Active Directory dans votre organisation). La valeur par défaut est False, ce qui signifie que les sessions de messagerie instantanée externes incluant des utilisateurs externes ne sont pas archivées.

ArchiveInternal

Facultatif

Booléen

Indique si les sessions de messagerie instantanée internes sont archivées (une session de messagerie instantanée interne est une session où tous les participants sont des utilisateurs authentifiés disposant de comptes Active Directory dans votre organisation). La valeur par défaut est False, ce qui signifie que les sessions de messagerie instantanée internes ne sont pas archivées.

Description

Facultatif

Chaîne

Permet aux administrateurs de fournir un texte supplémentaire concernant la stratégie. Par exemple, la propriété Description peut être utilisée pour décrire les utilisateurs auxquels la stratégie doit s’appliquer.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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

Objet Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy. Remove-CsArchivingPolicy accepte la saisie de données transmises via le pipeline pour les objets de stratégie d'archivage.

Types de retours

Set-CsArchivingPolicy ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy.

Exemple

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

Set-CsArchivingPolicy -Identity global -ArchiveInternal $True

Dans cet exemple, Set-CsArchivingPolicy est utilisé pour modifier la stratégie d’archivage globale. Dans ce cas, la propriété ArchiveInternal est définie sur True.

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

Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True

L’exemple 2 est une variante de la commande présentée dans l’exemple 1. Ici, toutefois, toutes les stratégies d’archivage de votre organisation sont configurées pour autoriser l’archivage des sessions de messagerie instantanée. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsArchivingPolicy pour renvoyer un ensemble de toutes les stratégies d’archivage de sessions de messagerie instantanée actuellement utilisées. Cet ensemble est ensuite redirigé vers la cmdlet Set-CsArchivingPolicy, qui définit la propriété ArchiveInternal de chaque stratégie sur True.