• Artikel

Set-CsAnalogDevice

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert ein vorhandenes Gerät in der Auflistung von Analoggeräten, die mit Microsoft Lync Server 2010 verwaltet werden können. Ein Analoggerät ist ein Telefon oder ein anderes Gerät, das mit dem Telefonfestnetz (PSTN, Public Switched Telephone Network) verbunden ist.

Syntax

Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-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 (d. h. die Voice over IP-Implementierung von Microsoft) 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 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 Set-CsAnalogDevice können Sie die Eigenschaften der Kontaktobjekte ändern, die den Analoggeräten zugeordnet sind. Sie können beispielsweise den Active Directory-Anzeigenamen des Kontakts oder den Anschluss-URI (Uniform Resource Identifier) ändern, der dem Telefon zugeordnet ist.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Benutzer-ID

Eindeutige ID für das zu ändernde Analoggerä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. Daher ist es für Sie u. U. einfacher, analoge Geräte mit dem Cmdlet Get-CsAnalogDevice zu ändern, um die analogen Geräteobjekte zurückzugeben und an Set-CsAnalogDevice weiterzuleiten.

Gateway

Optional

Zeichenfolge

Die IP-Adresse des PSTN-Gateways, das vom Analoggerät verwendet wird.

AnalogFax

Optional

Boolescher Wert

Wenn das Analoggerät ein Faxgerät ist, ist dieser Parameter auf "True" ($True) festgelegt. Wenn das Analoggerät kein Faxgerät ist, ist dieser Parameter auf "False" ($False) festgelegt.

LineURI

Optional

Zeichenfolge

Rufnummer des Analoggeräts. Der Anschluss-URI muss im E.164-Format angegeben werden und mit dem Präfix "TEL:" beginnen. Beispiel: TEL:+14255551297. Durchwahlnummern werden an das Ende des Anschluss-URI angehängt. Beispiel: TEL:+14255551297;ext=51297.

SipAddress

Optional

SIP-Adresse

Eindeutige ID, die eine Kommunikation zwischen dem Analoggerät und SIP-Geräten wie Microsoft Lync 2010 ermöglicht. Die SIP-Adresse muss mit dem Präfix "sip:" beginnen. Beispiel: sip:bldg14lobby@litwareinc.com.

DisplayName

Optional

Zeichenfolge

Konfiguriert den Active Directory-Anzeigenamen des Analoggeräts.

DisplayNumber

Optional

Zeichenfolge

Die in Lync 2010 angezeigte Telefonnummer. Die Eigenschaft "DisplayNumber" kann auf gewünschte Weise formatiert werden, z. B. 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234.

DomainController

Optional

Switch-Parameter

Ermöglicht es Ihnen, zum Ändern von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller verwenden Sie den Parameter "DomainController" und geben anschließend den Computernamen (z. B. "atl-mcs-001") oder den vollqualifizierten Domänennamen (FQDN) (z. B. "atl-mcs-001.litwareinc.com") an.

Enabled

Optional

True

Bei Festlegung auf "True" ($True) kann das analoge Gerät mit Lync Server 2010 verwendet werden.

EnterpriseVoiceEnabled

Optional

Boolescher Wert

Gibt an, ob das Kontaktobjekt für das Analoggerät für Enterprise-VoIP (d. h. die VoIP-Lösung von Microsoft) aktiviert wurde. Mit Enterprise-VoIP können Benutzer Anrufe über das Internet tätigen und müssen nicht länger das herkömmliche Telefonnetz nutzen.

PassThru

Optional

Switch-Parameter

Gibt ein Objekt zurück, das das Telefon in einem öffentlichen Bereich darstellt.

WhatIf

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

Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact-Objekt. Set-CsAnalogDevice akzeptiert weitergeleitete Instanzen des Analoggeräteobjekts.

Rückgabetypen

Set-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 --------------------------

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

Mit dem vorstehenden Befehl wird der Wert der Eigenschaft "LineUri" für das Analoggerät mit dem Identitätswert "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" geändert.

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

Der Befehl in Beispiel 2 ändert das Gateway für jedes Analoggerät, das derzeit das Gateway 192.168.0.240 verwendet. Hierzu ruft der Befehl das Cmdlet Get-CsAnalogDevice zusammen mit dem Parameter "Filter" auf. Der Filterwert "{Gateway -eq "192.168.0.240"}" stellt sicher, dass nur Geräte zurückgegeben werden, bei denen die Eigenschaft "Gateway" den Wert "192.168.0.240" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsAnalogDevice weitergeleitet, das für jedes Element der Auflistung den Wert der Eigenschaft "Gateway" in "192.168.1.100" ändert.