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.
Voir aussi
Autres ressources
Get-CsArchivingPolicy
Grant-CsArchivingPolicy
New-CsArchivingPolicy
Remove-CsArchivingPolicy