Move-CsUser
Letztes Änderungsdatum des Themas: 2012-03-23
Verschiebt ein oder mehrere für Microsoft Lync Server 2010 aktivierte Benutzerkonten in einen neuen Registrierungspool.
Syntax
Move-CsUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit dem Cmdlet Move-CsUser kann ein für Lync Server 2010 aktiviertes Benutzerkonto aus einem Registrierungspool in einen anderen verschoben werden. Move-CsUser wirkt sich lediglich auf den Kontospeicherort für Lync Server aus. Das Active Directory-Konto wird nicht in eine neue Organisationseinheit (Organizational Unit, OU) oder an einen anderen Speicherort verschoben.
Wenn Lync Server parallel zu Office Communications Server 2007 R2 oder Office Communications Server 2007 vorhanden ist, kann mit dem Cmdlet Move-CsUser ein Benutzer aus Lync Server zur älteren Installation von Office Communications Server zurück verschoben werden. Zum Verschieben eines Benutzers zurück nach Office Communications Server weisen Sie dem Parameter "Target" den vollqualifizierten Domänennamen (FQDN) des älteren Pools zu. Beachten Sie hierbei, dass zurück nach Office Communications Server verschobene Benutzer wahrscheinlich Funktionalitäts- und Datenverluste feststellen werden. Der Grund hierfür ist, dass Lync Server über mehr Funktionen als Office Communications Server 2007 oder Office Communications Server 2007 R2 verfügt. Zurück verschobene Benutzer müssen möglicherweise außerdem vorherige Versionen ihrer Clientsoftware installieren und Besprechungen neu planen, die erstellt wurden, als ihre Benutzerkonten sich noch in Lync Server befanden.
Zum Verschieben von Benutzern von Communications Server 2007 oder Communications Server 2007 R2 nach Lync Server verwenden Sie das Cmdlet Move-CsLegacyUser. Move-CsUser wurde entwickelt, um Benutzer von einem Lync Server- in einen anderen Lync Server-Pool zu verschieben oder um einen Benutzer von einem Lync Server-Pool in einen Office Communications Server-Pool zu verschieben. Move-CsLegacyUser verschiebt Benutzer aus Office Communications Server nach Lync Server.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Move-CsUser lokal auszufü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-CsUser"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserIdParameter |
Gibt die Identität des Benutzerkontos an, das verschoben werden soll. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Benutzeridentitäten können auch über den Active Directory-DN (Distinguished Name) des Benutzers referenziert werden. Sie können das Sternchen (*) als Platzhalterzeichen nutzen, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Der Identitätswert "* Smith" gibt beispielsweise alle Benutzer zurück, deren Anzeigename auf den Zeichenfolgenwert " Smith" endet. |
Target |
Erforderlich |
FQDN |
Der vollqualifizierte Domänenname (z. B. "atl-cs-001.litwareinc.com") des Registrierungspools, in den das Benutzerkonto verschoben werden soll. Neben einem Registrierungspool kann als Ziel auch der FQDN eines Legacy-Office Communications Server-Front-End-Servers oder eines Hostinganbieters angegeben werden. Alle zu einem Hostinganbieter verschobenen Konten (z. B. Microsoft Lync Online 2010) verlieren sämtliche ihnen zugeordneten Benutzerdaten. Beispielsweise werden alle vom Benutzer geplanten Konferenzen gelöscht und stehen in Lync Online 2010 nicht zur Verfügung. |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-cs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-cs-001.litwareinc.com") an. |
ProxyPool |
Optional |
Zeichenfolge |
Dieser Parameter wird nur für Microsoft Lync Online 2010 verwendet. Er sollte nicht mit einer lokalen Implementierung von Lync Server verwendet werden. |
Force |
Optional |
Switch-Parameter |
Wird dieser Parameter angegeben, wird das Benutzerkonto verschoben, zugeordnete Benutzerdaten (z. B. vom Benutzer geplante Konferenzen) werden jedoch gelöscht. Fehlt der Parameter, werden sowohl das Konto als auch die zugeordneten Daten verschoben. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Übergeben eines Benutzerobjekts für das Benutzerkonto, das verschoben wird. Das Cmdlet Move-CsUser leitet standardmäßig keine Objekte weiter. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Ermöglicht Ihnen das Umgehen der Bestätigungsaufforderung, die ansonsten beim Versuch zum Verschieben eines Benutzers angezeigt wird. Zum Umgehen der Bestätigungsaufforderung fügen Sie den Parameter "Confirm" mit folgender Syntax hinzu: -Confirm:$False Wenn Sie die Bestätigungsaufforderung lieber anzeigen möchten, verwenden Sie folgende Syntax: -Confirm |
Eingabetypen
Zeichenfolge oder Microsoft.Rtc.Management.ADConnect.Schema.ADUser-Objekt. Move-CsUser akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Lync Server aktivierten Benutzers darstellt. Das Cmdlet akzeptiert auch weitergeleitete Instanzen des Active Directory-Benutzerobjekts.
Rückgabetypen
Move-CsUser gibt keine Werte oder Objekte zurück. Stattdessen ändert das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADUser".
Beispiel
-------------------------- Beispiel 1 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
Im vorstehenden Beispiel wird Move-CsUser zum Verschieben des Benutzerkontos mit der Identität "Pilar Ackerman" in den Registrierungspool "atl-cs-001.litwareinc.com" verwendet.
-------------------------- Beispiel 2 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsUser -Target "atl-cs-001.litwareinc.com"
In Beispiel 2 werden sämtliche Benutzerkonten in der Organisationseinheit "Finance" in den Registrierungspool "atl-cs-001.litwareinc.com" verschoben. Zum Ausführen dieser Aufgabe verwendet der Befehl zunächst Get-CsUser und den Parameter "OU", um eine Sammlung aller Benutzerkonten in der OU "Finance" abzurufen. Nach dem Abruf dieser Daten werden die Informationen an Move-CsUser weitergeleitet, um die einzelnen Konten in der Auflistung in den Registrierungspool "atl-cs-001.litwareinc.com" zu verschieben.
-------------------------- Beispiel 3 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -Force
Im vorstehenden Beispiel wird Move-CsUser zum Verschieben des Benutzerkontos mit der Identität "Pilar Ackerman" in den Registrierungspool "atl-cs-001.litwareinc.com" verwendet. Zusätzlich wird der Parameter "Force" verwendet, um sicherzustellen, dass nur das Konto selbst verschoben wird. Die diesem Konto zugeordneten Benutzerdaten (z. B. von Pilar geplante Konferenzen) werden nicht verschoben, sondern stattdessen gelöscht. Der Parameter "Force" sollte nur verwendet werden, wenn Sie bereits versucht haben, "Move-CsUser" ohne Parameter aufzurufen, und wenn dieser Aufruf einen Fehler verursacht hat.