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.
Siehe auch
Weitere Ressourcen
Get-CsAnalogDevice
Move-CsAnalogDevice
Remove-CsAnalogDevice
Set-CsAnalogDevice