Partager via

  • Article

Set-CsCpsConfiguration

 

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

Modifie une collection de paramètres de service de parcage d’appel. La mise en garde (ou parcage) d’appels est un service qui permet à un utilisateur de « mettre en garde » un appel téléphonique entrant. Le parcage d’appels a pour effet de transférer ces derniers vers une plage spécifique, ou orbite, puis de les placer en attente. N’importe qui (et pas seulement la personne qui a répondu à l’appel) peut reprendre la conversation depuis le téléphone souhaité, en entrant simplement le chiffre correspondant.

Syntaxe

Set-CsCpsConfiguration [-Identity <XdsIdentity>] [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet permet de modifier une configuration de service de parcage d’appel. Une configuration de service de parcage d’appel spécifie l’action effectuée sur un appel une fois que celui-ci a été parqué. Par exemple, si un appel parqué reste sans réponse après un certain temps, il peut être automatiquement transféré à une autre personne, comme un administrateur ou un Response Group. Les appels peuvent être configurés pour émettre une sonnerie après une certaine durée, afin qu’on ne les oublie pas. De plus, le service de parcage d’appel peut être configuré pour diffuser une musique d’attente à l’appelant pendant le parcage de l’appel.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique de la configuration que vous souhaitez modifier. L’identité spécifie le niveau de l’étendue d’application de la configuration, c’est-à-dire au niveau global ou au niveau d’un site spécifique (au format site:<nom_site>, tel que site:Redmond).

Instance

Facultatif

CallParkServiceSettings

Référence à un objet de configuration de service de parcage d’appel, de type Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Cet objet peut être récupéré avec la cmdlet Get-CsCpsConfiguration. L’objet peut alors être modifié et les modifications peuvent être enregistrées en renvoyant l’objet vers Set-CsCpsConfiguration dans ce paramètre.

CallPickupTimeoutThreshold

Facultatif

TimeSpan

Temps qui s’écoule à partir du parcage d’un appel, avant que ce dernier soit de nouveau émis à destination du téléphone sur lequel l’appel a été répondu.

Ce paramètre doit être entré au format hh:mm:ss (hh = heures, mm = minutes, ss = secondes).

Valeur minimale : 10 secondes (00:00:10) ; valeur maximale : 10 minutes (00:10:00)

EnableMusicOnHold

Facultatif

Booléen

Détermine si une musique doit être diffusée à l’appelant pendant le parcage d’un appel.

Microsoft Lync Server 2010 est fourni avec un fichier d’attente musicale par défaut. Vous pouvez modifier ce fichier (et donc la musique qu’entend l’appelant pendant la durée de parcage) au moyen de la cmdlet Set-CsCallParkServiceMusicOnHoldFile.

MaxCallPickupAttempts

Facultatif

Int32

Nombre de tentatives de rappel effectuées pour un appel parqué vers le téléphone qui a répondu avant que l’appel soit abandonné et transféré vers l’URI (Uniform Resource Identifier) de secours. L’URI de secours est définie à l’aide du paramètre OnTimeoutURI.

Valeur minimale : 1 ; valeur maximale : 10

OnTimeoutURI

Facultatif

Chaîne

Adresse SIP de l’utilisateur ou du Response Group vers lequel les appels parqués restés sans réponse sont routés. L’appel parqué sera routé après avoir défini le nombre de rappels à l’aide du paramètre MaxCallPickupAttempts. Si ce paramètre a la valeur Null, le paramètre OnTimeoutURI sera ignoré et l’appel parqué sera déconnecté après les tentatives de rappel infructueuses.

Les valeurs doivent être des URI SIP et commencer par la chaîne sip:. Par exemple : sip:rgs1@litwareinc.com.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

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.Settings.CallParkServiceSettings.CallParkServiceSettings. Accepte les données transmises via le pipeline pour les objets de configuration de service de parcage d’appel.

Types de retours

Modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Exemple

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

Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

La commande illustrée dans l’exemple 1 modifie la configuration du service de parcage d’appel portant l’identité site:Redmond1 en définissant, pour l’appel parqué, le nombre maximum de rappels du téléphone ayant répondu sur 2. Pour cela, le paramètre MaxCallPickupAttempts est inclus et sa valeur est définie sur 2.

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

Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2

L’exemple 2 est une variation de la commande illustrée dans l’exemple 1. Dans ce cas, toutefois, la propriété MaxCallPickupAttempts de toutes les configurations du service de parcage d’appel est définie sur 2. Pour ce faire, Get-CsCpsConfiguration est utilisée pour récupérer une collection de tous les paramètres du service de parcage d’appel utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Set-CsCpsConfiguration, qui extrait chaque élément de la collection et définit à 2 la valeur de la propriété MaxCallPickupAttempts.

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

Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45

Cet exemple modifie la configuration du parcage d’appel pour le site Redmond1 en définissant sur 45 secondes la durée d’attente avant le rappel d’un appel mis en garde (contenu dans la propriété CallPickupTimeoutThreshold).