Move-CsApplicationEndpoint
Dernière rubrique modifiée : 2012-03-23
Déplace un point de terminaison vers un autre pool de serveurs d’inscriptions.
Syntaxe
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet déplace un objet contact de point de terminaison existant des services de domaine Active Directory (AD DS) depuis un pool d’applications Microsoft Office Communications Server 2007 R2 vers un pool d’applications Microsoft Lync Server 2010, ou depuis un pool d'applications Lync Server 2010 vers un autre. L’application associée au point de terminaison donné doit exister sur le pool de destination. Pour déterminer l’application associée au point de terminaison, exécutez la cmdlet Get-CsTrustedApplicationEndpoint ou Get-CsDialInConferencingAccessNumber.
Cette cmdlet permet aussi de mettre à niveau les propriétés de l’objet contact Active Directory lorsqu’une application déployée sur Office Communications Server 2007 R2 est redirigée vers Lync Server 2010. Notez que les pools d’applications source et cible seront identiques dans ce cas. De plus, si une application conçue initialement pour travailler sur Office Communications Server 2007 R2 est directement déployée sur Lync Server 2010, cette cmdlet doit être utilisée avec l’indicateur Force pour mettre à niveau les propriétés de l’objet contact Active Directory.
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-CsApplicationEndpoint : 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-CsApplicationEndpoint"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
PrimaryUriParameter |
Adresse SIP ou nom unique du contact du point de terminaison que vous souhaitez déplacer. |
TargetApplicationPool |
Obligatoire |
FQDN |
Nom de domaine complet (FQDN) du pool vers lequel le point de terminaison est déplacé. Le pool cible doit exécuter une dépendance du service Serveur d’inscriptions. |
DomainController |
Facultatif |
FQDN |
Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, c’est le premier contrôleur disponible qui sera utilisé. |
Force |
Facultatif |
Paramètre de commutateur |
Cet indicateur est obligatoire si vous déplacez un objet contact Microsoft Unified Communications Managed API (UCMA) 2.0 vers le même pool mais dans un déploiement Lync Server 2010, ce qui forcera l’acheminement via le service Serveur d’inscriptions Lync Server 2010. |
PassThru |
Facultatif |
Paramètre de commutateur |
La spécification de ce paramètre entraînera le renvoi de l’objet de point de terminaison d’application une fois l’objet déplacé. |
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
Chaîne. Accepte une valeur de chaîne redirigée représentant l’identité du point de terminaison d’une application.
Types de retours
Utilisée avec le paramètre PassThru, retourne un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemple
-------------------------- Exemple 1 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
Dans cet exemple, l’objet contact du point de terminaison d’application possédant l’adresse SIP endpoint1@litwareinc.com est déplacé vers le pool de serveurs d’inscriptions approuvé TrustPoolA.litwareinc.com. Cette commande permet de mettre à niveau une application UCMA 2.0 vers une application Microsoft Unified Communications Managed API (UCMA) 3.0 après coexistence.
-------------------------- Exemple 2 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
Dans cet exemple, l’objet contact du point de terminaison d’application possédant l’adresse SIP endpoint2@litwareinc.com est déplacé vers le pool de serveurs d’inscriptions approuvé TrustPoolA.litwareinc.com. Cet exemple diffère de l’exemple 1 puisque cette commande inclut le paramètre Force. Cette commande permet la migration sur site d’une application UCMA 2.0 ou le déploiement direct d’une application UCMA 2.0 par rapport à un déploiement Lync Server 2010 pur. Un objet existant dans Active Directory sera mis à jour avec les attributs nécessaires de sorte que l’acheminement puisse s’effectuer via le service Serveur d’inscriptions Lync Server 2010.