• Artikel

Remove-CsAnalogDevice

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt ein vorhandenes Gerät aus der Auflistung analoger Geräte, 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

Remove-CsAnalogDevice [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]

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 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 Richtlinien und Wähleinstellungen zuweisen.

Mit der Zeit kann es vorkommen, dass Sie ein einem analogen Gerät zugeordnetes Kontaktobjekt löschen müssen. Wenn Sie beispielsweise alle Faxgeräte außer Betrieb nehmen, benötigen Sie keine analogen Geräte (und Kontaktobjekte) mehr, die diesen Geräten zugeordnet sind. Das Cmdlet Remove-CsAnalogDevice ermöglicht das Löschen analoger Geräte. Bei Ausführung dieses Cmdlets wird das Gerät aus der Liste der analogen Geräte gelöscht, die von Get-CsAnalogDevice zurückgegeben werden. Außerdem wird das dem Gerät zugeordnete Kontaktobjekt aus Active Directory-Domänendienste (AD DS) gelöscht.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Active Directory-DN (Distinguished Name)

Eindeutige ID des zu entfernenden analogen Geräts. Analoge Geräte werden mithilfe des Active Directory-DN (Distinguished Name) des zugeordneten Kontaktobjekts identifiziert. Standardmäßig verwenden diese Geräte eine GUID (Globally Unique Identifier) als allgemeinen Namen, weshalb der Identitätswert analoger Geräte zumeist wie folgt aussieht: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Aus diesem Grund bietet es sich an, analoge Geräte mit dem Cmdlet Get-CsAnalogDevice abzurufen und die zurückgegebenen Objekte an das Cmdlet Remove-CsAnalogDevice weiterzuleiten.

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

Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact-Objekt. Remove-CsAnalogDevice akzeptiert weitergeleitete Objektinstanzen analoger Geräte.

Rückgabetypen

Mit Remove-CsAnalogDevice werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact" gelöscht.

Beispiel

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

Remove-CsAnalogDevice -Identity "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com"

Beispiel 1 löscht das analoge Gerät mit dem Identitätswert "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com".

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

Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"} | Remove-CsAnalogDevice

Mit dem Befehl in Beispiel 2 werden alle analogen Geräte gelöscht, denen der Anzeigename "Building 14 Receptionist" zugewiesen wurde. Hierzu wird Get-CsAnalogDevice mit dem Parameter "Filter" und dem Filterwert "{DisplayName -eq "Building 14 Receptionist"}" aufgerufen. Mit diesem Filterwert werden aus allen zurückgegebenen Objekten die analogen Geräte herausgefiltert, bei denen die Eigenschaft "DisplayName" den Wert "Building 14 Receptionist" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Die zurückgegebenen Elemente werden dann an Remove-CsAnalogDevice weitergeleitet und entfernt.

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

Get-CsAnalogDevice -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Remove-CsAnalogDevice

Mit dem vorstehenden Befehl werden alle analogen Geräte gelöscht, denen die VoIP-Richtlinie "RedmondVoicePolicy" zugewiesen wurde. Hierzu werden Get-CsAnalogDevice und der Parameter "Filter" zum Abrufen aller analogen Geräte verwendet, bei denen die Eigenschaft "VoicePolicy" dem Wert "RedmondVoicePolicy" entspricht. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsAnalogDevice weitergeleitet, um sämtliche Elemente in dieser Auflistung zu löschen.

-------------------------- Beispiel 4 ------------------------

Get-CsAnalogDevice -Filter {AnalogFax -eq $True} | Remove-CsAnalogDevice

Der Befehl in Beispiel 4 entfernt alle derzeit in der Organisation verwendeten analogen Faxgeräte. Hierzu wird Get-CsAnalogDevice mit dem Parameter "Filter" und dem Filterwert "{AnalogFax –eq $True"}" aufgerufen. Mit diesem Filterwert werden alle Geräte herausgefiltert, bei denen die Eigenschaft "AnalogFax" den Wert "True" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsAnalogDevice weitergeleitet, das alle Elemente aus der Auflistung entfernt.