Freigeben über

  • Artikel

Move-CsLegacyUser

 

Letztes Änderungsdatum des Themas: 2012-05-21

Migriert ein oder mehrere Benutzerkonten von Microsoft Office Communications Server 2007 R2 oder Microsoft Office Communications Server 2007 zu Microsoft Lync Server 2010.

Syntax

Move-CsLegacyUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExcludeArchivingPolicy <SwitchParameter>] [-ExcludeConferencingPolicy <SwitchParameter>] [-ExcludeDialPlan <SwitchParameter>] [-ExcludeExternalAccessPolicy <SwitchParameter>] [-ExcludePresencePolicy <SwitchParameter>] [-ExcludeVoicePolicy <SwitchParameter>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Viele Organisationen, die Lync Server 2010 installieren, führen auch eine frühere Version der Software (entweder Office Communications Server 2007 R2 oder Office Communications Server 2007) aus. Dies stellt glücklicherweise kein Problem dar: Sie können die aktuelle und eine frühere Version der Software gleichzeitig ausführen. Im Laufe der Zeit können Sie dann Ihre Konfigurationseinstellungen, Ihre Richtlinien und schließlich Ihre Benutzerkonten zu Lync Server 2010 migrieren.

Mit dem Cmdlet Move-CsLegacyUser können Sie nicht nur Benutzer zu Lync Server 2010 migrieren, sondern den Migrationsprozess in vollem Umfang steuern. Sie können z. B. für Move-CsLegacyUser den Identitätswert des zu migrierenden Benutzers und den vollqualifizierten Domänennamen (FQDN) des Lync Server 2010-Registrierungspools, in dem das Benutzerkonto verwaltet wird, ganz einfach festlegen. Dann wird das Benutzerkonto mit Move-CsLegacyUser verschoben, und alle vorhandenen Richtlinien und Einstellungen, die auf dieses Konto angewendet wurden, werden beibehalten. Beispiel: Ken Myer wurde in Office Communications Server ein Satz mit Wähleinstellungen zugewiesen. Wenn Sie Kens Benutzerkonto migrieren, wird standardmäßig auch der Satz mit Wähleinstellungen migriert: Dies bedeutet, dass Ken Myer mit Move-CsLegacyUser automatisch der äquivalente Satz mit Wähleinstellungen von Lync Server 2010 zugewiesen wird, der ihm in Communications Server 2007 R2 zugewiesen wurde.

Dies tritt selbstverständlich nur auf, wenn migrierte Wähleinstellungen und ein äquivalenter Satz mit Wähleinstellungen von Lync Server 2010 vorhanden sind, der Ken Myer in Communications Server 2007 R2 zugewiesen wurde. Möglicherweise haben Sie sich auch dazu entschieden, Lync Server 2010 ohne die Migration von Wähleinstellungen zu installieren. In diesem Fall können Sie Move-CsLegacyUser mit dem Parameter "ExcludeDialPlan" aufrufen. Wenn Sie diesen Parameter verwenden, werden keine Wähleinstellungen mit dem Benutzerkonto migriert. Das heißt, dass das Benutzerkonto von Ken Myer zu Lync Server 2010 verschoben, ihm aber kein Satz mit Wähleinstellungen zugewiesen wird. (Dies ist auch dann der Fall, wenn Sie tatsächlich Wähleinstellungen migriert haben. Mit dem Parameter "ExcludeDialPlan" wird verhindert, dass dem migrierten Benutzerkonto ein Satz mit Wähleinstellungen zugewiesen wird.) Mit anderen Parametern können Sie VoIP-Richtlinien, Konferenzrichtlinien, Archivierungsrichtlinien, Richtlinien für den externen Zugriff bzw. Anwesenheitsrichtlinien beim Migrieren von Benutzerkonten ausschließen.

Bevor Sie Merge-CsLegacyTopology ausführen können, müssen Sie zunächst das Schnittstellenpaket für die Abwärtskompatibilität mit Windows Management Instrumentation (WMI) installieren, was durch Ausführen der Datei "OCSWMIBC.msi" erfolgt. (Die Datei "OCSWMIBC.msi" finden Sie auf der Installations-DVD im Ordner "Setup".) Nach der Installation des Schnittstellenpakets für die Abwärtskompatibilität kann Merge-CsLegacyUser aufgerufen werden, um ein oder mehrere Benutzerkonten von Communications Server 2007 R2 oder Communications Server 2007 zu Lync Server 2010 zu migrieren.

Wenn Sie einen Benutzer von Lync Server zurück zu Office Communications Server migrieren müssen, verwenden Sie nicht nicht das Cmdlet Move-CsLegacyUser. Verwenden Sie stattdessen das Cmdlet Move-CsUser, und legen Sie den FQDN des vorhandenen Office Communications Server-Pools als Parameterwert für den Parameter "Target" von Move-CsUser fest. Beispiel:

Move-CsUser –Identity "Ken Myer" –Target "ocs13.litwareinc.com"

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Move-CsLegacyUser 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-CsLegacyUser"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Gibt den Identitätswert des Benutzerkontos an, das migriert 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) Anzeigename des Benutzers in den Active Directory-Domänendiensten (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

Zeichenfolge

FQDN des Registrierungspools, in dem das Benutzerkonto verwaltet werden soll. Beispiel: -Target atl-cs-001.litwareinc.com.

DomainController

Optional

Zeichenfolge

Ermöglicht es Ihnen, zum Verschieben eines Benutzerkontos 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.

ExcludeArchivingPolicy

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene Archivierungsrichtlinien (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ExcludeConferencingPolicy

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene Konferenzrichtlinien (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ExcludeDialPlan

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene Wähleinstellungen (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ExcludeExternalAccessPolicy

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene Richtlinien für den externen Zugriff (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ExcludePresencePolicy

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene Anwesenheitsrichtlinien (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ExcludeVoicePolicy

Optional

Switch-Parameter

Dem Benutzerkonto zugewiesene VoIP-Richtlinien (sofern angegeben) werden nicht beibehalten, wenn das Konto migriert wird.

ProxyPool

Optional

Zeichenfolge

Dieser Parameter wird nur mit Microsoft Lync Online 2010 verwendet. Er sollte nicht mit einer lokalen Implementierung von Lync Server verwendet werden.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

PassThru

Optional

Switch-Parameter

Ermöglicht das Übergeben eines Benutzerobjekts für das Benutzerkonto, das verschoben wird. Mit dem Cmdlet Move-CsLegacyUser werden Objekte standardmäßig nicht weitergeleitet.

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

Keine. Move-CsLegacyUser akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Move-CsLegacyUser gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADUser" verschoben.

Beispiel

-------------------------- Beispiel 1 --------------------------

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"

Im vorstehenden Beispiel wird Move-CsLegacyUser zum Migrieren des Benutzerkontos mit dem Identitätswert "Pilar Ackerman" zum Registrierungspool "atl-cs-001.litwareinc" verwendet. Da keine zusätzlichen Parameter eingeschlossen werden, werden ebenfalls alle Richtlinien oder Einstellungen migriert, die diesem Konto zuvor zugewiesen wurden. Wenn Pilar Ackerman also eine Legacy-Richtlinie (z. B. ein Satz mit Wähleinstellungen) zugewiesen wurde, wird ihr im Zuge der Migration Ihres Kontos der äquivalente Satz mit Lync Server 2010-Wähleinstellungen zugewiesen.

-------------------------- Beispiel 2 --------------------------

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -ExcludeDialPlan

Der Befehl in Beispiel 2 migriert das Benutzerkonto von Pilar Ackerman. Es werden aber keine Wähleinstellungen migriert, die ihrem Konto zuvor zugewiesen wurden. Nachdem das Konto migriert wurde, besitzt Pilar keinen zugewiesenen Satz mit Wähleinstellungen.

-------------------------- Beispiel 3 --------------------------

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

In Beispiel 3 werden sämtliche Benutzerkonten in der OU "Finance" in den Lync Server-Registrierungspool "atl-cs-001.litwareinc.com" verschoben. Hierzu verwendet der Befehl zunächst Get-CsUser und den Parameter "OU", um eine Sammlung aller Benutzerkonten in der OU "Finance" abzurufen. Nachdem die Konten abgerufen wurden, wird die Auflistung an das Cmdlet Move-CsLegacyUser weitergeleitet, das jedes Konto in den neuen Registrierungspool verschiebt. Bei diesem Befehl wird davon ausgegangen, dass es sich bei allen Benutzern in der OU "Finance" um Legacy-Benutzer handelt.

-------------------------- Beispiel 4 --------------------------

Get-CsUser -UnassignedUser | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

Im vorstehenden Beispiel wird "Move-CsLegacyUser" dazu verwendet, einen Registrierungspool zu allen Benutzern zuzuweisen, die für Lync Server aktiviert wurden, jedoch derzeit keinem Registrierungspool zugewiesen sind. In diesem Befehl wird zunächst das Cmdlet Get-CsUser mit dem Parameter "UnassignedUser" aufgerufen, um eine Auflistung aller Benutzer zurückzugeben, die gegenwärtig keinem Registrierungspool zugewiesen sind. Diese Auflistung wird anschließend an Move-CsLegacyUser weitergeleitet, um die einzelnen Benutzer dem Pool "atl-cs-001.litwareinc.com" zuzuweisen. Bei diesem Beispiel wird davon ausgegangen, dass es sich bei allen nicht zugewiesenen Benutzern um Legacy-Benutzer handelt.