Get-CsAnalogDevice
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen über die Analoggeräte zurück, die Sie mit Microsoft Lync Server 2010 verwalten können. Ein Analoggerät ist ein Telefon oder ein anderes Gerät, das mit dem Telefonfestnetz verbunden ist.
Syntax
Get-CsAnalogDevice [-Identity] <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
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".
Neben analogen Telefonen und Telefonen, die Enterprise-VoIP nutzen, gibt es eine weitere Art von Telefon: digitale Nicht-IP-Telefone. Diese Telefone gehören zu der Nebenstellenanlage (PBX, Private Branch Exchange), mit der sie erworben wurden, und können nicht über Lync Server 2010-Cmdlets verwaltet werden.
Damit Administratoren analoge Geräte für Organisationen 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 beispielsweise Richtlinien und Wähleinstellungen zuweisen.
Mit dem Cmdlet Get-CsAnalogDevice können Informationen zu den analogen Geräten abgerufen werden, die in Ihrer Organisation konfiguriert wurden. Wenn Sie Get-CsAnalogDevice ohne Parameter ausführen, gibt das Cmdlet Informationen zu allen analogen Geräten zurück. Mithilfe optionaler Parameter können Sie die Informationen filtern. Beispielsweise können Sie alle Geräte zurückgeben, die über Kontaktobjekte in einer bestimmten Organisationseinheit (OU) verfügen, oder Sie geben alle analogen Geräte in einem bestimmten Gebäude zurück usw.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsAnalogDevice lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsAnalogDevice"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Benutzer-ID |
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. |
Credential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ermöglicht die Ausführung des Cmdlets Get-CsAnalogDevice mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung an Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Kontaktobjekten zu arbeiten. Zur Verwendung des Parameters "Credential" muss zunächst über das Cmdlet Get-Credential ein Objekt "PSCredential" erstellt werden. Einzelheiten finden Sie im Hilfethema zum Cmdlet "Get-Credential". |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Um eine Verbindung mit einem bestimmten Domänencontroller herzustellen, fügen Sie den Parameter "DomainController" ein, gefolgt vom vollqualifizierten Domänennamen (FQDN) des Computers, z. B. "atl-cs-001.litwareinc.com". |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Lync Server 2010-spezifischen Attributen gefiltert werden. Die zurückgegebenen Daten können z. B. auf Kontaktobjekte für analoge Geräte beschränkt werden, die einer bestimmten VoIP-Richtlinie zugewiesen sind, oder auf Kontakte, denen keine spezifische VoIP-Richtlinie zugewiesen wurde. Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Ein Filter, der beispielsweise nur Faxgeräte zurückgibt, sieht folgendermaßen aus. "AnalogFax" repräsentiert das Active Directory-Attribut, "-eq" den Vergleichsoperator "equal to" und "$True" (eine integrierte Windows PowerShell-Variable) den Filterwert: -Filter {AnalogFax -eq $True} |
LdapFilter |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, die zurückgegebenen Daten durch das Filtern allgemeiner Active Directory-Attribute einzuschränken (d. h. Attribute, die nicht Lync Server 2010-spezifisch sind). Beispielsweise können Sie die zurückgegebenen Daten auf Kontaktobjekte beschränken, die einer bestimmten Abteilung zugewiesen sind oder sich in einem bestimmten Gebäude befinden. Der Parameter "LdapFilter" verwendet beim Erstellen von Filtern die LDAP-Abfragesprache. Der folgende Filter gibt beispielsweise nur Kontaktobjekte zurück, die analoge Geräte in der Stadt Redmond repräsentieren: -LdapFilter "l=Redmond" Im vorstehenden Filter ist "l" das Active Directory-Attribut ("l" steht für "locality", Deutsch: Ort), "=" ist der Vergleichsoperator (equal to) und "Redmond" der Filterwert. |
OU |
Optional |
Active Directory-DN (Distinguished Name) |
Ermöglicht es Ihnen, Kontaktobjekte aus einer bestimmten Active Directory-Organisationseinheit (Organizational Unit, OU) zurückzugeben Dabei werden Daten aus der angegebenen Organisationseinheit und allen untergeordneten Organisationseinheiten zurückgegeben. Wenn die OU "Finance" z. B. über zwei untergeordnete OUs verfügt – "AccountsPayable" und "AccountsReceivable" – werden alle Informationen zu analogen Geräten aus diesen OUs zurückgegeben. Verwenden Sie beim Angeben einer Organisationseinheit den Distinguished Name des Containers, z. B.: -OU "OU=Finance,dc=litwareinc,dc=com". |
ResultSize |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Anzahl von zurückgegebenen Datensätzen einzuschränken. Um beispielsweise sieben analoge Geräte zurückzugeben (unabhängig von der Anzahl von analogen Geräten in der Gesamtstruktur), verwenden Sie den Parameter "ResultSize" und setzen seinen Wert auf 7. Beachten Sie, dass nicht garantiert werden kann, welche sieben analogen Geräte zurückgegeben werden. Wenn Sie "ResultSize" auf 7 setzen, jedoch lediglich über drei analoge Geräte in Ihrer Gesamtstruktur verfügen, werden diese drei analogen Geräte zurückgegeben, und der Befehl wird anschließend ohne Fehler abgeschlossen. Für die Ergebnisgröße kann ein ganzzahliger Wert zwischen einschließlich 0 und 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben. |
Eingabetypen
Zeichenfolge. Get-CsAnalogDevice akzeptiert einen weitergeleiteten Zeichenfolgenwert, der den Identitätswert des analogen Geräts darstellt.
Rückgabetypen
Mit Get-CsAnalogDevice werden Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsAnalogDevice
Der Befehl in Beispiel 1 gibt eine Auflistung aller analogen Geräte zurück, die für die Organisation konfiguriert wurden. Dazu wird Get-CsAnalogDevice ohne Parameter aufgerufen.
-------------------------- Beispiel 2 ------------------------
Get-CsAnalogDevice | Select-Object DisplayName, LineUri
In Beispiel 2 werden nur zwei Eigenschaftswerte – "DisplayName" und "LineUri" – für alle analogen Geräte in der Organisation zurückgegeben. Dazu ruft der Befehl zunächst Get-CsAnalogDevice ohne Parameter auf. Dadurch wird eine Auflistung aller Eigenschaftswerte für sämtliche in der Organisation verwendeten analogen Geräte zurückgegeben. Diese Auflistung wird anschließend an das Cmdlet Select-Object weitergeleitet, das nur die Werte der Eigenschaften "DisplayName" und "LineUri" herausfiltert und anzeigt.
-------------------------- Beispiel 3 ------------------------
Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"}
In Beispiel 3 werden Informationen zu einem analogen Gerät mit dem Active Directory-Anzeigenamen "Building 14 Receptionist" zurückgegeben. Hierzu ruft der Befehl das Cmdlet Get-CsAnalogDevice mit dem Parameter "Filter" auf. Der Filterwert "{DisplayName -eq "Building 14 Receptionist"}" schränkt die zurückgegebenen Objekte auf analoge Geräte ein, deren Eigenschaft "DisplayName" den Wert "Building 14 Receptionist" aufweist (der Vergleichsoperator "-eq" steht für "equal to").
-------------------------- Beispiel 4 ------------------------
Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}
Im vorstehenden Befehl werden alle analogen Geräte zurückgegeben, die für das Gateway 192.168.0.240 konfiguriert wurden. Hierzu wird das Cmdlet Get-CsAnalogDevice mit dem Parameter "Filter" aufgerufen. Der Filterwert 192.168.0.240 stellt sicher, dass nur die Objekte für analoge Geräte zurückgegeben werden, deren Eigenschaft "Gateway" den Wert 192.168.0.240 aufweist.
-------------------------- Beispiel 5 ------------------------
Get-CsAnalogDevice -Filter {AnalogFax -eq $True}
Mit dem Befehl in Beispiel 5 werden Informationen zu allen analogen Faxgeräten in der Organisation zurückgegeben. Hierzu ruft der Befehl Get-CsAnalogDevice mit dem Parameter "Filter" auf. Der Filterwert "{AnalogFax -eq $True}" beschränkt die zurückgegebenen Objekte auf Faxgeräte: analoge Geräte, deren Eigenschaft "AnalogFax" den Wert "True" aufweist.
-------------------------- Beispiel 6 ------------------------
Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}
In Beispiel 6 wird ein einzelnes analoges Gerät zurückgegeben: das Gerät, dessen Eigenschaft "LineUri" (Telefonnummer) den Wert "tel:+14255556001" aufweist.
-------------------------- Beispiel 7 ------------------------
Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}
In Beispiel 7 werden alle analogen Geräte mit der Ortsvorwahl 425 oder dem Rufnummernpräfix 555 zurückgegeben. Hierzu wird das Cmdlet Get-CsAnalogDevice mit dem Parameter "Filter" aufgerufen. Der Filterwert "{LineUri -like "tel:+1425555*"}" schränkt die zurückgegebenen Daten auf Geräte ein, bei denen die Eigenschaft "LineUri" mit den Zeichen "tel:+1425555" beginnt. Dies entspricht einer Rufnummer, die mit 1425555 beginnt (Beispiel: 1-425-555-1298).
-------------------------- Beispiel 8 ------------------------
Get-CsAnalogDevice -OU "ou=Telecommunications,dc=litwareinc,dc=com"
Mit dem vorstehenden Befehl wird eine Auflistung aller analogen Geräte zurückgegeben, die über ein Kontaktobjekt in der OU "Telecommunications" in Active Directory-Domänendienste (AD DS) verfügen. Hierzu wird das Cmdlet Get-CsAnalogDevice mit dem Parameter "OU" aufgerufen. Der Parameterwert schränkt die zurückgegebenen Objekte auf analoge Geräte ein, die über Kontaktobjekte in der OU mit dem Distinguished Name (DN) "ou=Telecommunications,dc=litwareinc,dc=com" verfügen.
-------------------------- Beispiel 9 --------------------------
Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"
Der Befehl in Beispiel 9 zeigt, wie Sie eine Auflistung analoger Geräte zurückgeben und dann jedem Gerät in der Auflistung eine VoIP-Richtlinie zuweisen können. Hierzu wird Get-CsAnalogDevice zunächst ohne Parameter aufgerufen, um eine Auflistung aller in der Organisation konfigurierten analogen Geräte zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Grant-CsVoicePolicy weitergeleitet, das jedem der Geräte in der Auflistung die VoIP-Richtlinie "AnalogVoicePolicy" zuweist.
Siehe auch
Weitere Ressourcen
Move-CsAnalogDevice
New-CsAnalogDevice
Remove-CsAnalogDevice
Set-CsAnalogDevice