Remove-CsCommonAreaPhone

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt ein vorhandenes Telefon in einem öffentlichen Bereich aus der Auflistung von Telefonen, die mit Microsoft Lync Server 2010 verwaltet werden. Telefone in öffentlichen Bereichen sind Telefone in Eingangsbereichen von Gebäuden, Aufenthaltsräumen für Mitarbeiter oder in anderen Bereichen, in denen sie oftmals von vielen Menschen und für unterschiedliche Benutzer genutzt werden.

Syntax

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

Detaillierte Beschreibung

Telefone in öffentlichen Bereichen sind IP-Telefone, die keinem einzelnen Benutzer zugeordnet sind. Sie befinden sich nicht in einem Büro, sondern normalerweise in Eingangsbereichen, Cafeterias, Aufenthaltsräumen für Mitarbeiter, Besprechungszimmern und anderen Bereichen, in denen viele Menschen zusammenkommen. Die Verwaltung solcher Telefone stellt für Administratoren eine Herausforderung dar, da die Telefonnutzung in Lync Server 2010 normalerweise anhand verschiedener VoIP-Richtlinien und Wähleinstellungen verwaltet wird, die einzelnen Benutzern zugewiesen sind. Telefonen in öffentlichen Bereichen sind keine einzelnen Benutzer zugewiesen.

Eine Methode zur Bewältigung dieser Herausforderung besteht darin, Active Directory-Kontaktobjekte für alle Telefone in öffentlichen Bereichen zu erstellen. (Diese Kontaktobjekte können mit dem Cmdlet New-CsCommonAreaPhone erstellt werden.) Diesen Kontaktobjekten können dann genau wie Benutzerkonten Richtlinien und VoIP-Einstellungen zugewiesen werden. Auf diese Weise können Sie Telefone in öffentlichen Bereichen verwalten, auch wenn sie keinem einzelnen Benutzer zugeordnet sind. Wenn Benutzer beispielsweise nicht die Möglichkeit haben sollen, Anrufe von einem Telefon im öffentlichen Bereich aus weiterzuleiten oder zu parken, können Sie eine VoIP-Richtlinie erstellen, die die Weiterleitung und das Parken von Anrufen verhindert. Weisen Sie diese Richtlinie dann dem Telefon im öffentlichen Bereich zu. (Genauer gesagt, weisen Sie diese Richtlinie dem Kontaktobjekt zu, das für das Telefon im öffentlichen Bereich steht.) Mit dem folgenden Befehl wird z. B. allen Telefonen in öffentlichen Bereichen die VoIP-Richtlinie "CommonAreaPhoneVoicePolicy" zugewiesen:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

Gelegentlich müssen Sie möglicherweise das Kontaktobjekt löschen, das einem Telefon im öffentlichen Bereich zugeordnet ist. Wenn Sie beispielsweise das Telefon aus einem Aufenthaltsraum für Mitarbeiter entfernen, muss diesem Telefon kein Kontaktobjekt mehr zugeordnet sein. Das Cmdlet Remove-CsCommonAreaPhone bietet Ihnen eine Möglichkeit, Telefone in öffentlichen Bereichen zu löschen. Wenn Sie dieses Cmdlet ausführen, wird das Telefon aus der Liste von Telefonen in öffentlichen Bereichen gelöscht, die über Get-CsCommonAreaPhone zurückgegeben wird. Zusätzlich wird das dem jeweiligen Telefon 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-CsCommonAreaPhone 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-CsCommonAreaPhone"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Benutzer-ID

Eindeutige ID des Telefons im öffentlichen Bereich. Telefone in öffentlichen Bereichen werden mit dem Distinguished Name des zugeordneten Kontaktobjekts in Active Directory identifiziert. Telefone in öffentlichen Bereichen verwenden standardmäßig eine GUID (Globally Unique Identifier) als allgemeinen Namen (Common Name, CN), deshalb verfügen Telefone 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 möglicherweise einfacher, Telefone in öffentlichen Bereichen mit dem Cmdlet Get-CsCommonAreaPhone abzurufen und dann die zurückgegebenen Objekte an Remove-CsCommonAreaPhone 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.OCSADCommonAreaPhoneContact-Objekt. Remove-CsCommonAreaPhone akzeptiert weitergeleitete Objektinstanzen des Telefons im öffentlichen Bereich.

Rückgabetypen

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

Beispiel

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

Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"} | Remove-CsCommonAreaPhone

Der Befehl in Beispiel 1 löscht das Telefon im allgemeinen Bereich mit dem Anzeigenamen "Building 14 Lobby". Hierzu ruft der Befehl zunächst Get-CsCommonAreaPhone mit dem Parameter "Filter" und dem Filterwert "{DisplayName -eq "Building 14 Lobby"}" auf. Das zurückgegebene Objekt wird dann an das Cmdlet Remove-CsCommonAreaPhone weitergeleitet und damit gelöscht.

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

Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null} | Remove-CsCommonAreaPhone

In Beispiel 2 löscht der Befehl alle Telefone in öffentlichen Bereichen, denen keine Wähleinstellungen zugeordnet wurden. Hierzu wird zuerst Get-CsCommonAreaPhone mit dem Parameter "Filter" verwendet, um die angegebenen Elemente zurückzugeben; der Filterwert "{DialPlan -eq $Null}" beschränkt die zurückgegebenen Daten auf Telefone in öffentlichen Bereichen, denen keine Wähleinstellungen zugeordnet wurden. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsCommonAreaPhone weitergeleitet, das jedes Telefon in der Auflistung löscht.

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

Get-CsCommonAreaPhone -OU "ou=Redmond,dc=litwareinc,dc=com" | Remove-CsCommonAreaPhone

In Beispiel 3 werden alle Telefone in öffentlichen Bereichen gelöscht, die Kontaktobjekte in der Organisationseinheit "Redmond" in Active Directory aufweisen. Hierzu wird zuerst Get-CsCommonAreaPhone aufgerufen, um alle Telefone in öffentlichen Bereichen zurückzugeben, deren Kontaktobjekte sich in der Organisationseinheit "Redmond" befinden. Zum Einschränken der Daten auf die angegebene Organisationseinheit wird der Parameter "OU" mit dem Parameterwert "ou=Redmond,dc=litwareinc,dc=com" verwendet. Die zurückgegebene Auflistung wird dann an Remove-CsCommonAreaPhone weitergeleitet, um sämtliche Telefone in der Auflistung zu löschen.