Partager via

  • Article

Set-CsExUmContact

 

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

Modifie un objet de contact Standard automatique ou Accès abonné existant pour le service de messagerie unifiée Exchange hébergé.

Syntaxe

Set-CsExUmContact -Identity <UserIdParameter> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Microsoft Lync Server 2010 agit de concert avec la messagerie unifiée Exchange pour fournir plusieurs fonctionnalités vocales dont Standard automatique et Accès abonné. Lorsque la messagerie unifiée Exchange est fournie en tant que service hébergé (plutôt que sur site), des objets contact doivent être créés à l'aide de Windows PowerShell pour appliquer les fonctionnalités Standard automatique et Accès abonné. Ces objets sont créés en appelant la cmdlet New-CsExUmContact et peuvent être modifiés par la suite à l’aide de la cmdlet Set-CsExUmContact.

Le moyen le plus simple d’utiliser cette cmdlet est souvent d’appeler d’abord la cmdlet Get-CsExUmContact pour récupérer une instance de l’objet de contact que vous souhaitez modifier. Redirigez simplement le résultat de votre commande Get-CsExUmContact vers la cmdlet Set-CsExUmContact et affectez des valeurs aux paramètres pour les propriétés que vous souhaitez modifier. (Pour plus d'informations, consultez la section Exemples de cette rubrique.) Vous pouvez également appeler la cmdlet Set-CsExUmContact en lui transmettant l’identité de l’objet de contact à modifier.

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-CsExUmContact : 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 "Set-CsExUmContact"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Identificateur unique de l'objet contact que vous souhaitez modifier. Les identités de contact peuvent être spécifiées dans l’un des quatre formats suivants : 1) l'adresse SIP du contact ; 2) le nom d'utilisateur principal (UPN) du contact ; 3) le nom de domaine et le nom d'ouverture de session du contact, sous la forme domaine\ouverture de session (par exemple, litwareinc\exum1) ; et 4) le nom complet Active Directory du contact (par exemple, Standard automatique d'équipe).

Type de données complet : Microsoft.Rtc.Management.AD.UserIdParameter

AutoAttendant

Facultatif

Booléen

Définissez le paramètre sur True si l’objet de contact est un standard automatique. Ce paramètre a la valeur False par défaut.

Description

Facultatif

Chaîne

Description de ce contact. La description permet aux administrateurs d’identifier le type de contact (Standard automatique ou Accès abonné), l’emplacement, le fournisseur ou toute autre information qui identifiera l’objectif de chaque contact de messagerie unifiée Exchange.

DisplayNumber

Facultatif

Chaîne

Numéro de téléphone du contact. Les numéros affichés pour chaque contact doivent être unique (deux contacts messagerie unifiée Exchange ne peuvent pas avoir le même numéro de téléphone affiché). Toute modification de cette valeur entraînera aussi une modification de la valeur de la propriété LineURI.

Cette valeur peut commencer par un signe plus (+) et contenir autant de chiffres que nécessaire. Le premier chiffre doit être différent de zéro.

Enabled

Facultatif

Booléen

Indique si le contact a été activé pour Lync Server 2010. Si vous définissez ce paramètre sur False, le contact sera désactivé et le standard automatique ou l’accès abonné qui lui est associé ne fonctionnera plus.

Si vous désactivez un compte au moyen du paramètre Enabled, les informations associées à ce compte (y compris les stratégies de messagerie vocale hébergée) sont conservées. Si, par la suite, vous réactivez le compte à l’aide du paramètre Enabled, les informations de compte associées seront restaurées.

EnterpriseVoiceEnabled

Facultatif

Booléen

Indique si le contact a été activé pour Enterprise Voice. Si vous définissez cette valeur sur False, le standard automatique ou l’accès abonné associé à ce contact ne sera plus disponible.

SipAddress

Facultatif

Chaîne

Adresse SIP du contact. Il doit s’agir d’une nouvelle adresse qui n’existe pas encore comme utilisateur ou contact dans services de domaine Active Directory (AD DS).

Toute modification de cette valeur modifie également l'adresse SIP stockée dans la propriété OtherIpPhone.

La valeur SipAddress peut servir d’identité permettant aux commandes Get-CsExUmContact d’extraire des contacts spécifiques. Lors de l’appel de cette cmdlet, la nouvelle valeur SipAddress sera utilisée ; les requêtes de l’ancienne adresse SIP ne renverront aucun objet.

DomainController

Facultatif

FQDN

Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, le système utilisera le premier disponible.

PassThru

Facultatif

Paramètre de commutateur

Retourne les résultats de la commande. Par défaut, cette cmdlet ne génère aucune sortie.

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.ADConnect.Schema.OCSADExUmContact. Accepte la saisie de données transmises via le pipeline pour les objets contact de messagerie unifiée Exchange.

Types de retours

Cette cmdlet modifie un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Si le paramètre PassThru est utilisé, elle renvoie également un objet de même type.

Exemple

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

Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True

Cet exemple définit sur True la propriété AutoAttendant du contact de messagerie unifiée Exchange avec l’adresse SIP exumsa4@fabrikam.com. Il nous faut d’abord appeler l’objet Get-CsExUmContact pour récupérer l’objet de contact. (Nous aurions pu utiliser le nom complet Active Directory du contact, son nom d’utilisateur principal ou son nom d’ouverture de session.) Cette commande récupère le contact pertinent avec l’identité fournie. Ce contact est ensuite transmis à la cmdlet Set-CsExUmContact pour laquelle nous avons défini le paramètre AutoAttendant sur True.

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

Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True

Cet exemple est identique à l’exemple 1 mais au lieu de récupérer le contact en appelant Get-CsExUmContact, puis en redirigeant cet objet vers Set-CsExUmContact, nous allons préciser à la cmdlet Set-CsExUmContact l’identité du contact à modifier. Notez le format de l’identité : dans ce cas, nous avons utilisé le nom unique complet de l'objet de contact qui comprend un GUID généré automatiquement lors de la création du contact. Il nous faut ensuite définir le paramètre AutoAttendant du contact sur True.