Move-CsExUmContact
Dernière rubrique modifiée : 2012-03-23
Déplace un ou plusieurs contacts de la messagerie unifiée Exchange vers un nouveau pool de serveurs d’inscriptions.
Syntaxe
Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-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, y compris les standards automatiques et l’accès abonné. Move-CsExUmContact vous permet de déplacer un objet contact de la messagerie unifiée Exchange vers un nouveau pool de serveurs d’inscriptions. Les objets contacts peuvent être déplacés du pool Microsoft Office Communications Server 2007 ou Microsoft Office Communications Server 2007 R2 vers un pool Lync Server 2010, ou encore d’un pool Lync Server 2010 à un autre. Cette cmdlet ne déplace pas d’objet contact messagerie unifiée Exchange d’un pool Lync Server 2010 vers un pool Office Communications Server 2007 ou Office Communications Server 2007 R2.
Quand un objet contact de messagerie unifiée Exchange est déplacé, les propriétés AutoAttendant et IsSubscriberAccess sont définies de la manière appropriée, en fonction de la valeur de la propriété OtherIpPhone de l’objet.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Move-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 "Move-CsExUmContact"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Paramètre ID utilisateur |
Identificateur unique de l’objet contact que vous souhaitez déplacer. 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). |
Target |
Obligatoire |
FQDN |
Nom de domaine complet du pool de serveurs d’inscriptions vers lequel le contact est déplacé. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
DomainController |
Facultatif |
FQDN |
Vous permet de vous connecter au contrôleur de domaine spécifié. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-mcs-001) ou de son nom de domaine complet (par exemple, atl-mcs-001.litwareinc.com). |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
PassThru |
Facultatif |
Paramètre de commutateur |
Permet de transmettre un objet contact via le pipeline qui représente le compte du contact à déplacer. Par défaut, la cmdlet Move-CsExUmContact ne transmet aucun objet par le biais du pipeline. |
ProxyPool |
Facultatif |
FQDN |
Ce paramètre est utilisé uniquement pour les instances hébergées de Lync Server. Il ne doit pas être utilisé avec une implémentation sur site de Lync Server. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Types d’entrées
Chaîne. Accepte une valeur de chaîne transmise via le pipeline, représentant l’identité d’un objet messagerie unifiée Exchange à déplacer.
Types de retours
Appelée avec le paramètre PassThru, retourne un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.
Exemple
-------------------------- Exemple 1 ------------------------
Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com
L’exemple 1 déplace l’objet contact messagerie unifiée Exchange dont l’adresse SIP est exum1@fabrikam.com vers le pool de serveurs d’inscriptions dont le nom de domaine complet est atl-cs-001.litwareinc.com. Notez qu’une invite de confirmation s’affiche quand vous exécutez cette commande, même si nous n’avons pas inclus le paramètre Confirm. Cette invite s’affiche même si vous incluez le paramètre Force.
-------------------------- Exemple 2 ------------------------
Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com
Cet exemple déplace tous les objets contact messagerie unifiée Exchange de type Standard automatique vers le pool de serveurs d’inscriptions dont le nom de domaine complet est atl-cs-001.litwareinc.com. L’exemple débute par un appel de Get-CsExUmContact qui retourne tous les contacts messagerie unifiée Exchange qui ont été définis. Cette collection de contacts est ensuite redirigée vers la cmdlet Where-Object, qui recherche tous les contacts de la collection ayant une valeur de propriété AutoAttendant définie sur True ($True), indiquant ainsi que le contact est de type Standard automatique.
Enfin, la collection de contacts pour lesquels la propriété AutoAttendant est définie sur True est redirigée vers la cmdlet Move-CsExUmContact, qui déplace les contacts vers le pool de serveurs d’inscriptions spécifié dans le paramètre Target.
Tout comme dans l’exemple 1, vous serez invité à confirmer votre action lors de l’exécution de cette commande.
Voir aussi
Autres ressources
New-CsExUmContact
Remove-CsExUmContact
Set-CsExUmContact
Get-CsExUmContact