• Artikel

Move-CsAnalogDevice

 

Letztes Änderungsdatum des Themas: 2012-03-23

Verschiebt ein oder mehrere analoge Geräte in einen neuen Registrierungspool. Ein Analoggerät ist ein Telefon oder ein anderes Gerät, das mit dem Telefonfestnetz (PSTN, Public Switched Telephone Network) verbunden ist.

Syntax

Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Zu den Analoggeräten gehören Telefone, Faxgeräte, Modems und TTY/TTD-Geräte (Telekommunikationsgeräte für Hörgeschädigte), die mit dem Telefonfestnetz (Public Switched Telephone Network, PSTN) verbunden sind. Im Gegensatz zu Geräten, die Enterprise-VoIP (die Microsoft-Implementierung von Voice over IP) nutzen, werden bei analogen Geräten Informationen nicht als digitale Pakete übertragen. Stattdessen werden Informationen mithilfe eines Dauersignals übertragen. Dieses Signal wird gemeinhin als analoges Signal bezeichnet, daher der Begriff "analoge Geräte".

Damit Administratoren analoge Geräte verwalten können, ermöglicht Microsoft Lync Server 2010 das Zuordnen analoger Geräte zu Active Directory-Kontaktobjekten. Nachdem ein Gerät einem Kontaktobjekt zugeordnet wurde, können Sie das analoge Gerät verwalten, indem Sie dem Kontakt Richtlinien und Wähleinstellungen zuweisen.

Mit dem Cmdlet Move-CsAnalogDevice können Sie ein bestehendes analoges Gerät in einen neuen Registrierungspool verschieben.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Move-CsAnalogDevice lokal ausführen: RTCUniversalUserAdmins. Berechtigungen zum Ausführen dieses Cmdlets für bestimmte Standorte oder spezifische Active Directory-Organisationseinheiten (OUs) können mit dem Cmdlet Grant-CsOUPermission zugewiesen werden. 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-CsAnalogDevice"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserID

Eindeutige ID für das analoge Gerät. Analoge Geräte werden mithilfe des Active Directory-DN (Distinguished Name) des zugeordneten Kontaktobjekts identifiziert. Analoge Geräte verwenden standardmäßig eine GUID (Globally Unique Identifier) als allgemeinen Namen (Common Name, CN), deshalb verfügen Geräte in der Regel über einen Identitätswert wie den folgenden: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Target

Erforderlich

FQDN

Der vollqualifizierte Domänenname (FQDN) (z. B. "atl-cs-001.litwareinc.com") des Registrierungspools, in den das analoge Gerät verschoben werden soll. Neben einem Registrierungspool kann als Ziel auch der FQDN eines Hostinganbieters angegeben werden.

DomainController

Optional

FQDN

Ermöglicht es Ihnen, zum Verschieben eines analogen Geräts 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

FQDN

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 analoge Gerät verschoben, zugeordnete Daten (z. B. dem Gerät zugewiesene Richtlinien) werden jedoch gelöscht. Wenn dieser Parameter nicht angegeben wird, wird das Gerät mit den zugeordneten Daten verschoben.

PassThru

Optional

Switch-Parameter

Ermöglicht das Übergeben eines Benutzerobjekts für das Benutzerkonto, das verschoben wird. Das Cmdlet Move-CsAnalogDevice 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

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Zeichenfolge. Move-CsAnalogDevice akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität des analogen Geräts repräsentiert.

Rückgabetypen

Move-CsAnalogDevice gibt standardmäßig keine Objekte oder Werte zurück. Wenn Sie jedoch den Parameter "PassThru" verwenden, gibt das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact" zurück.

Beispiel

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

Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

Der Befehl in Beispiel 1 verschiebt das analoge Gerät mit dem Identitätswert "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" in den Registrierungspool "atl-cs-001.litwareinc.com".

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

In Beispiel 2 wird das analoge Gerät mit dem Active Directory-Anzeigenamen "Building 14, Room 142" in den Registrierungspool "atl-cs-001.litwareinc.com" verschoben. Hierzu wird zunächst Get-CsAnalogDevice ohne Parameter aufgerufen, um eine Auflistung aller derzeit in der Organisation verwendeten analogen Geräte zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das alle Geräte mit dem Anzeigenamen "Building 14, Room 142" herausfiltert. Diese gefilterte Auflistung wird dann an das Cmdlet Move-CsAnalogDevice weitergeleitet, das alle Geräte in der Auflistung in den Registrierungspool "atl-cs-001.litwareinc.com" verschiebt.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

Mit dem vorstehenden Befehl werden alle analogen Geräte verschoben, deren Anzeigename mit der Zeichenfolge "Building 14" beginnt. Hierzu ruft der Befehl zunächst Get-CsAnalogDevice auf, um eine Auflistung aller derzeit in der Organisation verwendeten analogen Geräte zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das alle Geräte herausfiltert, deren Anzeigename mit der Zeichenfolge "Building 14" beginnt. Die gefilterte Auflistung wird dann an das Cmdlet Move-CsAnalogDevice weitergeleitet, das alle Geräte in der Auflistung in den Registrierungspool "atl-cs-001.litwareinc.com" verschiebt.