Partager via

  • Article

New-CsCpsConfiguration

 

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

Crée une nouvelle collection de paramètres de service de mise en garde d’appels. 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’un appel a pour effet de transférer ce dernier dans une plage définie, ou « orbite », et de le mettre immédiatement en attente. N’importe qui (pas seulement la personne qui a répondu à l’appel) peut reprendre la conversation depuis le téléphone souhaité, en entrant le numéro correct.

Syntaxe

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

Description détaillée

Cette cmdlet permet de créer une nouvelle configuration de service de mise en garde d’appels. Lors de l’installation du service de mise en garde d’appels, des paramètres globaux sont configurés par défaut : vous pouvez les mettre à jour mais pas les supprimer. (La « suppression » des paramètres globaux permet simplement de rétablir leurs valeurs par défaut.) Cette cmdlet est donc utilisée pour créer uniquement des paramètres propres à des sites.

Une configuration de service de mise en garde d’appels spécifie l’action effectuée sur un appel une fois que celui-ci a été mis en garde. Par exemple, si un appel mis en garde 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 pour s’assurer qu’ils n’ont pas été oubliés. De plus, le service de mise en garde d’appels peut être configuré pour diffuser une musique d’attente à l’appelant pendant la mise en garde 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 New-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 "New-CsCpsConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Site auquel les paramètres sont appliqués. Vous devez l’entrer en utilisant le format site:<nom_site> (par exemple, site:Redmond). Comme une configuration existe toujours au niveau de l’étendue globale et qu’elle ne peut pas être supprimée, vous ne pouvez pas recréer une configuration globale avec cette cmdlet.

CallPickupTimeoutThreshold

Facultatif

TimeSpan

Temps qui s’écoulera après le parcage d’un appel avant que ce dernier ne soit de nouveau émis à destination du téléphone sur lequel l’appel a été répondu.

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

Valeur par défaut : 00:01:30 (90 secondes) ; valeur minimale : 10 secondes (00:00:10) ; valeur maximale : 10 minutes (00:10:00)

EnableMusicOnHold

Facultatif

Booléen

Détermine si une musique est diffusée pour 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 ainsi donc la musique qu’entend l’appelant pendant le parcage) au moyen de la cmdlet Set-CsCallParkServiceMusicOnHoldFile.

Valeur par défaut : True

MaxCallPickupAttempts

Facultatif

Int32

Nombre de tentatives de rappel effectuées pour un appel mis en garde vers le téléphone qui a répondu avant que l’appel ne 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 par défaut : 1 ; valeur minimale : 1 ; valeur maximale : 10

OnTimeoutURI

Facultatif

Chaîne

Adresse SIP de l’utilisateur ou du groupe Response Group vers lequel les appels mis en garde non répondus seront routés. L’appel mis en garde 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 et l’appel mis en garde sera déconnecté après plusieurs 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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

Cette cmdlet crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Exemple

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

New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

La commande de l’exemple 1 utilise la cmdlet New-CsCpsConfiguration pour créer une configuration de service de mise en garde d’appels pour le site Redmond1. Cette configuration est créée avec des valeurs par défaut, à l’exception de la propriété EnableMusicOnHold. Cette commande définit cette propriété sur False, ce qui signifie que l’appelant dont les appels ont été mis en garde n’entendra rien au cours de son attente. (Par défaut, la propriété EnableMusicOnHold a la valeur True, à condition que le service de mise en garde d’appels ait été déployé.)

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

New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

La commande de l’exemple 2 utilise la cmdlet New-CsCpsConfiguration pour créer une configuration de service de mise en garde d’appels pour le site Redmond1. Par défaut, aucun paramètre OnTimeoutURI n’est fourni ; l’exemple ajoute donc une valeur pour ce paramètre. Dans ce cas précis, le paramètre OnTimeoutURI est défini sur sip:kenmyer@litwareinc.com. La valeur qui lui est transmise doit commencer par la chaîne « sip: » et doit pointer sur un utilisateur ou un groupe Response Group qui recevra les appels mis en garde non traités après un nombre précis de tentatives de rappel.

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

New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Cette commande se sert de la cmdlet New-CsCpsConfiguration pour créer une configuration de service de mise en garde d’appels pour le site Redmond1. Pour ce site, le paramètre MaxCallPickupAttempts a été défini sur 2, ce qui signifie que deux rappels seront effectués pour cet appel.