Freigeben über

  • Artikel

Get-CsAllowedDomain

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Domänen zurück, die in der Liste der für den Partnerverbund genehmigten Domänen enthalten sind. Nachdem eine Domäne für den Partnerverbund (durch Hinzufügen zur Zulassungsliste) genehmigt wurde, können die Benutzer Sofortnachrichten und Anwesenheitsinformationen mit Personen austauschen, die über ein Konto in dieser Domäne verfügen.

Syntax

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

Get-CsAllowedDomain [-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 Microsoft Lync 2010 miteinander kommunizieren. Microsoft 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 Ihre Zugriffs-Edgeserver für den Partnerverbund aktivieren. 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 (erforderlich, wenn "EnablePartnerDiscovery" deaktiviert wurde), stellt die Organisationen dar, mit denen Sie einen Partnerverbund einrichten möchten. Wenn eine Domäne in der Zulassungsliste angezeigt wird, können Ihre Benutzer (je nach den Konfigurationseinstellungen) Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, die über ein Konto in dieser 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.

Das Cmdlet Get-CsAllowedDomain bietet eine Möglichkeit, Informationen zu allen Domänen in der Liste zugelassener Domänen zurückzugeben.

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

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 Zulassungsliste 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 ist, werden alle Domänen zurückgegeben, die in der Liste zugelassener Domänen aufgeführt sind.

Filter

Optional

Zeichenfolge

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

LocalStore

Optional

Switch-Parameter

Ruft die zulässigen Domänen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsAllowedDomain akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

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

Beispiel

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

Get-CsAllowedDomain

Der vorstehende Befehl gibt eine Auflistung aller Domänen zurück, die in der Liste der für den Partnerverbund genehmigten Domänen enthalten sind. Beim Aufruf von Get-CsAllowedDomain ohne zusätzliche Parameter wird immer die vollständige Auflistung der genehmigten Domänen zurückgegeben.

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

Get-CsAllowedDomain -Identity fabrikam.com

In Beispiel 2 werden Informationen zur zulässigen Domäne mit dem Identitätswert "fabrikam.com" zurückgegeben. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur ein Element zurück.

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

Get-CsAllowedDomain -Filter *fabrikam*

Der Befehl in Beispiel 3 gibt eine Auflistung aller zulässigen Domänen zurück, die den Zeichenfolgenwert "fabrikam" in ihrem Identitätswert enthalten. Dazu verwendet der Befehl den Parameter "Filter" und den Filterwert "*fabrikam*". Dieser Filter weist Get-CsAllowedDomain an, nur die Domänen zurückzugeben, bei denen die Eigenschaft "Identity" (die einzige Eigenschaft, nach der gefiltert werden kann) den Zeichenfolgenwert "fabrikam" enthält. Durch diesen Befehl werden Domänen wie "fabrikam.com", "fabrikam.net" und "africa.fabrikam.org" zurückgegeben.

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

Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null}

In Beispiel 4 werden die Cmdlets Get-CsAllowedDomain und Where-Object verwendet, um eine Auflistung aller Domänen zurückzugeben, bei denen kein Wert für die Eigenschaft "ProxyFqdn" eingegeben wurde. Hierzu wird zunächst Get-CsAllowedDomain ohne zusätzliche Parameter aufgerufen, um eine Auflistung aller zulässigen Domänen zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das diejenigen Domänen herausfiltert, deren Eigenschaft "ProxyFqdn" einen Nullwert aufweist. Nullwert bedeutet, dass kein Wert für "ProxyFqdn" eingegeben wurde. Um alle Domänen zu ermitteln, für die für die Eigenschaft "ProxyFqdn" ein Wert konfiguriert wurde, verwenden Sie stattdessen diese Syntax:

Where-Object {$_.ProxyFqdn -ne $Null}

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

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $True}

Der vorstehende Befehl gibt alle zulässigen Domänen wieder, deren Integritätsstatus vom Monitoring Server überwacht wird. Dazu wird zunächst Get-CsAllowedDomain verwendet, um eine Auflistung aller Domänen in der Liste der zulässigen Domänen zurückzugeben. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, bei denen die Eigenschaft "MarkForMonitoring" den Wert "True" aufweist.