• Artikel

New-CsAnalogDevice

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt ein neues analoges Gerät, das mit Microsoft Lync Server 2010 verwaltet werden kann. Ein Analoggerät ist ein Telefon oder ein anderes Gerät, das mit dem Telefonfestnetz (PSTN, Public Switched Telephone Network) verbunden ist.

Syntax

New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <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 (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 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.

Neue Analoggeräte werden mit dem Cmdlet New-CsAnalogDevice erstellt. Dieses Cmdlet kann entweder neue Kontaktobjekte für die Verwendung mit Analoggeräten erstellen oder einem neuen Gerät vorhandene Kontaktobjekte zuweisen. Ausführliche Informationen finden Sie unter den Beschreibungen für die Parameter "OU" und "DN" in diesem Thema.

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

Parameter

Parameter Erforderlich Typ Beschreibung

LineUri

Erforderlich

Zeichenfolge

Rufnummer des Analoggeräts. Der Anschluss-URI (Uniform Resource Identifier) muss im E.164-Format angegeben werden und mit dem Präfix "TEL:" beginnen. Beispiel: TEL:+14255551297. Durchwahlnummern werden am Ende des Anschluss-URI hinzugefügt. Beispiel: TEL:+14255551297;ext=51297.

SipAddress

Optional

SIP-Adresse

Eindeutige ID (ähnlich einer E-Mail-Adresse), mit der das Analoggerät mit SIP-Geräten wie Microsoft Lync 2010 kommunizieren kann. Die SIP-Adresse muss mit dem Präfix "sip:" beginnen. Beispiel: sip:bldg14lobby@litwareinc.com.

RegistrarPool

Erforderlich

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) des Registrierungspools, in dem sich das Kontaktobjekt befindet. Beispiel: -RegistrarPool "atl-cs-001.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.

AnalogFax

Erforderlich

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.

Gateway

Erforderlich

Zeichenfolge

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

OU

Erforderlich

Active Directory-DN (Distinguished Name)

Distinguished Name (DN) der Active Directory-Organisationseinheit (OU), in der sich das Kontaktobjekt befinden soll. Beispiel: -OU "ou=Redmond,dc=litwareinc,dc=com".

Wenn Sie den Parameter "OU" angeben, wird in der angegebenen Organisationseinheit (OU, Organizational Unit) ein neuer Kontakt erstellt. Der Kontakt wird automatisch einer GUID (Globally Unique Identifier) als allgemeiner Name zugewiesen. Der Name des Kontaktobjekts könnte dann folgendermaßen aussehen: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

DN

Optional

Active Directory-DN (Distinguished Name)

Ermöglicht es Ihnen, dem Analoggerät ein bestehendes Active Directory-Kontaktobjekt zuzuweisen. Wenn Sie einem Analoggerät ein Kontaktobjekt zuweisen möchten, verwenden Sie den Parameter "DN", gefolgt vom Distinguished Name dieses Kontakts. Beispiel: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Beachten Sie, dass beim Ausführen des Befehls ein Fehler auftritt, wenn der angegebene Kontakt nicht vorhanden ist.

Sie können die Parameter "OU" und "DN" nicht in demselben Befehl verwenden.

PassThru

Optional

Switch-Parameter

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

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. New-CsAnalogDevice akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsAnalogDevice werden neue Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact" erstellt.

Beispiel

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

New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Der Befehl in Beispiel 1 erstellt ein neues Analoggerät mit der Telefonnummer (LineUri) 1-425-555-6001. (Beachten Sie, dass die Telefonnummer im E.164-Format angegeben werden muss.) Zusätzlich zum Parameter "LineUri" werden in diesem Befehl folgende Parameter verwendet: "DisplayName" zum Festlegen des Active Directory-Anzeigenamens des Geräts, "RegistrarPool" zum Angeben des Registrierungspools, "AnalogFax" (auf "$False" festgelegt) als Hinweis darauf, dass es sich um ein Telefon und nicht um ein Faxgerät handelt, "Gateway" zum Angeben der IP-Adresse des Gateways und "OU" zum Angeben des Distinguished Name der Active Directory-OU, in der das Kontaktobjekt des Geräts erstellt werden soll.