Freigeben über

  • Artikel

Get-CsBlockedDomain

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Domänen zurück, die in der Liste der für den Partnererbund blockierten Domänen enthalten sind. Laut Definition können Benutzer Microsoft Lync Server 2010-Anwendungen nicht für die Kommunikation mit Personen in der blockierten Domäne verwenden. Benutzer können beispielswiese mit Microsoft Lync 2010 keine Sofortnachrichten mit Personen austauschen, deren SIP-Konto (Session Initiation Protocol) in einer Domäne in der Liste blockierter Domänen enthalten ist.

Syntax

Get-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsBlockedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Ein Partnerverbund ist eine Möglichkeit, mit der zwei Organisationen eine Vertrauensstellung einrichten können, die die Kommunikation zwischen den beiden Gruppen erleichtert. Wenn ein Partnerverbund eingerichtet wurde, können Benutzer in beiden Organisationen einander Sofortnachrichten senden, Anwesenheitsbenachrichtigungen abonnieren und mithilfe von SIP-Anwendungen wie Lync 2010 miteinander kommunizieren. Lync Server 2010 bietet drei Arten des Partnerverbunds: 1) direkter Partnerverbund zwischen Ihrer und einer anderen Organisation, 2) Partnerverbund zwischen Ihrer Organisation und einem öffentlichen Anbieter und 3) Partnerverbund zwischen Ihrer Organisation und einem externen Hostinganbieter.

Das Einrichten eines direkten Partnerverbunds mit einer anderen Organisation ist mit mehreren Aufgaben verbunden. Zunächst müssen Sie den Lync Server-Zugriffs-Edgedienst so konfigurieren, dass ein Partnerverbund zulässig ist. Außerdem muss die andere Organisation den Partnerverbund mit Ihnen zulassen. Ein Partnerverbund kann nur eingerichtet werden, wenn beide Parteien mit der Partnververbundbeziehung einverstanden sind.

Zur Einrichtung einer Partnerverbundbeziehung ist möglicherweise auch die Verwaltung von zwei partnerverbundbezogenen Listen erforderlich: Zulassungsliste und Blockierliste. Die Zulassungsliste enthält die Organisationen, mit denen Sie im Partnerverbund stehen. Wenn eine Domäne in dieser Liste angezeigt wird, können Ihre Benutzer (je nach den Konfigurationseinstellungen) Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, die über ein Konto in der Partnerdomäne verfügen. Die Blockierliste enthält Domänen, mit denen der Partnerverbund ausdrücklich untersagt ist. Nachrichten, die von einer blockierten Domäne gesendet werden, werden automatisch von Lync Server 2010 abgelehnt.

Mit dem Cmdlet Get-CsBlockedDomain können Informationen zu den Domänen zurückgegeben werden, die in der Liste der blockierten Domänen enthalten sind.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsBlockedDomain lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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-CsBlockedDomain"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Name der Domäne, die zurückgegeben werden soll. Domänen werden mit ihrem vollqualifizierten Domänennamen (FQDN) in der Blockierliste aufgeführt. Dies bedeutet, dass der Identitätswert für eine bestimmte Domäne beispielsweise "fabrikam.com" oder "contoso.net" lauten kann. Beim Angeben des Identitätswerts für eine Domäne können keine Platzhalterzeichen verwendet werden. Verwenden Sie für eine Platzhaltersuche nach einer bestimmten (oder mehreren Domänen) stattdessen den Parameter "Filter".

Wenn dieser Parameter nicht angegeben wird, werden alle Domänen in der Liste der blockierten Domänen zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine oder mehrere Domänen aus der Liste der blockierten Domänen zurückzugeben. Verwenden Sie folgende Syntax, um alle Domänen zurückzugeben, deren Identitätswert mit dem Buchstaben "r" beginnt: -Filter r*. Verwenden Sie folgende Syntax, um alle Domänen zurückzugeben, deren Identitätswert auf ".net" endet: -Filter "*.net". Verwenden Sie folgende Syntax, um alle Domänen zurückzugeben, deren Identitätswert mit "f" oder "g" beginnt: -Filter [fg]*.

LocalStore

Optional

Switch-Parameter

Ruft die Daten zur blockierten Domäne aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsBlockedDomain akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Gibt eine Instanz des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain" zurück.

Beispiel

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

Get-CsBlockedDomain

Der Befehl in Beispiel 1 gibt eine Auflistung aller Domänen zurück, die in der Liste blockierter Domänen enthalten sind. Hierzu wird Get-CsBlockedDomain ohne zusätzliche Parameter aufgerufen.

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

Get-CsBlockedDomain -Identity fabrikam.com

In Beispiel 2 ist die einzige zurückgegebene blockierte Domäne diejenige mit dem Identitätswert "fabrikam.com". Da Domänen in der Blockierliste eindeutige Identitätswerte haben müssen, wird mit diesem Befehl nur maximal ein Element zurückgegeben.

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

Get-CsBlockedDomain -Filter *.net

In Beispiel 3 wird der Parameter "Filter" verwendet, um eine Auflistung aller blockierten Domänen mit einem Identitätswert zurückzugeben, der auf die Zeichenfolge ".net" endet. Dieses Beispiel gibt Domänen wie "northwindtraders.net", "contoso.net" und "fabrikam.net" zurück.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}

Der vorstehende Befehl gibt eine Auflistung aller Domänen zurück, bei der die Eigenschaft "Comment" keinen Wert aufweist. Hierzu ruft der Befehl zunächst Get-CsBlockedDomain auf, um eine Auflistung aller in der Liste der blockierten Domänen enthaltenen Domänen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, bei denen die Eigenschaft "Comment" einen Nullwert aufweist (der Vergleichsoperator "-eq" steht für "equal to").

-------------------------- Beispiel 5 --------------------------

Get-CsBlockedDomain | Where-Object {$_.Comment -match "Ken Myer"}

In Beispiel 5 werden alle blockierten Domänen zurückgegeben, deren Eigenschaft "Comment" die Zeichenfolge "Ken Myer" an beliebiger Stelle enthält. Hierzu ruft der Befehl zunächst Get-CsBlockedDomain auf, um eine Auflistung aller in der Liste blockierter Domänen enthaltenen Domänen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, bei denen die Eigenschaft "Comment" den Zeichenfolgenwert "Ken Myer" enthält.