Move-CsApplicationEndpoint
Letztes Änderungsdatum des Themas: 2012-03-23
Verschiebt einen Endpunkt in einen anderen Registrierungspool.
Syntax
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird ein vorhandenes Endpunktkontaktobjekt in Active Directory-Domänendienste (AD DS) aus einem Microsoft Office Communications Server 2007 R2-Anwendungspool in einen Microsoft Lync Server 2010-Anwendungspool oder aus einem Lync Server 2010-Anwendungspool in einen anderen verschoben. Die dem vorgegebenen Endpunkt zugeordnete Anwendung muss im Zielpool vorhanden sein. Führen Sie das Cmdlet Get-CsTrustedApplicationEndpoint oder das Cmdlet Get-CsDialInConferencingAccessNumber aus, um zu ermitteln, welche Anwendung dem Endpunkt zugeordnet ist.
Dieses Cmdlet wird auch zum Aktualisieren der Active Directory-Kontaktobjekteigenschaften verwendet, wenn eine für Office Communications Server 2007 R2 bereitgestellte Anwendung für Lync Server 2010 konfiguriert werden soll. Beachten Sie, dass der Quell- und Zielanwendungspool in diesem Fall identisch sind. Wenn eine Anwendung, die ursprünglich zur Verwendung mit Office Communications Server 2007 R2 gedacht war, direkt für Lync Server 2010 bereitgestellt wird, muss dieses Cmdlet mit dem Flag "Force" ausgeführt werden, um die Active Directory-Kontaktobjekteigenschaften zu aktualisieren.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Move-CsApplicationEndpoint lokal ausführen: RTCUniversalUserAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsApplicationEndpoint"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
PrimaryUriParameter |
Die SIP-Adresse oder der Distinguished Name (DN) des Endpunktkontakts, den Sie verschieben möchten. |
TargetApplicationPool |
Erforderlich |
FQDN |
Der vollqualifizierte Domänenname (FQDN) des Pools, in den der Endpunkt verschoben wird. Der Zielpool muss über eine Zuweisung zu einem Registrierungsdienst verfügen. |
DomainController |
Optional |
FQDN |
Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet. |
Force |
Optional |
Switch-Parameter |
Dieses Flag ist erforderlich, wenn Sie ein Microsoft Unified Communications Managed-API (UCMA) 2.0-Kontaktobjekt in denselben Pool, jedoch in einer anderen Lync Server 2010-Bereitstellung verschieben. Auf diese Weise wird ein Routing über die Lync Server 2010-Registrierung erzwungen. |
PassThru |
Optional |
Switch-Parameter |
Durch die Angabe dieses Parameters wird das Anwendungsendpunktobjekt zurückgegeben, nachdem das Objekt verschoben wurde. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines Anwendungsendpunkts repräsentiert.
Rückgabetypen
Bei Verwendung mit dem Parameter "PassThru" wird ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
In diesem Beispiel wird das Anwendungsendpunkt-Kontaktobjekt mit der SIP-Adresse "endpoint1@litwareinc.com" in den vertrauenswürdigen Registrierungspool "TrustPoolA.litwareinc.com" verschoben. Verwenden Sie diesen Befehl, um nach einer Koexistenzphase ein Upgrade der UCMA 2.0-Anwendung auf eine Microsoft Unified Communications Managed-API (UCMA) 3.0-Anwendung durchzuführen.
-------------------------- Beispiel 2 -------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
In diesem Beispiel wird das Anwendungsendpunkt-Kontaktobjekt mit der SIP-Adresse "endpoint2@litwareinc.com" in den vertrauenswürdigen Registrierungspool "TrustPoolA.litwareinc.com" verschoben. Dieses Beispiel weicht von Beispiel 1 darin ab, dass der Befehl den Parameter "Force" einschließt. Verwenden Sie diesen Befehl für eine direkte Migration einer UCMA 2.0-Anwendung oder für die direkte Bereitstellung einer UCMA 2.0-Anwendung für eine reine Lync Server 2010-Bereitstellung. Mit diesem Befehl wird ein vorhandenes Objekt in Active Directory mit den erforderlichen Attributen aktualisiert, damit das Routing über die Lync Server 2010-Registrierung erfolgen kann.