Freigeben über


New-CsBlockedDomain

 

Letztes Änderungsdatum des Themas: 2012-03-23

Fügt der Liste der für den Partnerverbund blockierten Domänen eine neue Domäne hinzu. Laut Definition können Benutzer Microsoft Lync Server 2010-Anwendungen nicht für die Kommunikation mit Personen aus der blockierten Domäne verwenden. Benutzer können beispielsweise mit Microsoft Lync 2010 keine Sofortnachrichten mit Personen austauschen, deren SIP-Konto in einer Domäne in der Liste blockierter Domänen enthalten ist.

Syntax

New-CsBlockedDomain -Identity <XdsGlobalRelativeIdentity> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsBlockedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<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 die Server, auf denen der Lync Server-Zugriffs-Edgedienst ausgeführt wird, 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 Partnerverbundbeziehung einverstanden sind.

Zur Einrichtung einer Partnerverbundbeziehung ist möglicherweise auch die Verwaltung von zwei partnververbundbezogenen 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 New-CsBlockedDomain können Sie der Liste blockierter Domänen eine Domäne hinzufügen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) der Domäne, die der Blockierliste hinzugefügt werden soll, z. B. "fabrikam.com". Sie können zum Festlegen des Domänennamens den Parameter "Identity" oder "Domain" verwenden (aber nicht beide). Wenn Sie "Identity" verwenden, wird die Eigenschaft "Domain" auf denselben Wert festgelegt, der "Identity" zugewiesen ist. Wenn Sie "Domain" verwenden, wird die Eigenschaft "Identity" auf denselben Wert festgelegt, der "Domain" zugewiesen ist.

Beachten Sie, dass Identitäten eindeutig sein müssen: Wenn die angegebene Domäne bereits auf der Blockier- oder Zulassungsliste vorhanden ist, tritt beim Ausführen des Befehls ein Fehler auf.

Comment

Optional

Zeichenfolge

Optionaler Zeichenfolgenwert, der zusätzliche Informationen zu der blockierten Domäne liefert. Sie können beispielsweise einen Kommentar hinzufügen, der erläutert, warum die Domäne blockiert wurde.

Domain

Optional

Zeichenfolge

FQDN (z. B. "fabrikam.com") der Domäne, die der Blockierliste hinzugefügt werden soll. Sie können zum Festlegen des Domänennamens den Parameter "Identity" oder "Domain" verwenden (aber nicht beide). Wenn Sie "Identity" verwenden, wird die Eigenschaft "Domain" auf denselben Wert festgelegt, der "Identity" zugewiesen ist. Wenn Sie "Domain" verwenden, wird die Eigenschaft "Identity" auf denselben Wert festgelegt, der "Domain" zugewiesen ist.

Beachten Sie, dass Domänen eindeutig sein müssen: Wenn die angegebene Domäne bereits auf der Blockier- oder Zulassungsliste vorhanden ist, tritt beim Ausführen des Befehls ein Fehler auf.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsBlockedDomain akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain".

Beispiel

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

New-CsBlockedDomain -Identity "fabrikam.com" -Comment "Blocked per Ken Myer."

Im vorstehenden Beispiel wird die Domäne "fabrikam.com" der Liste der blockierten Domänen hinzugefügt. Dazu wird New-CsBlockedDomain zusammen mit dem Parameter "Identity" aufgerufen, dem der Name der zu blockierenden Domäne zugewiesen wird. Außerdem wird der Parameter "Comment" angegeben, um der blockierten Domäne einen Kommentar hinzuzufügen. Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftritt, wenn "fabrikam.com" bereits in der Blockierliste oder in der Zulassungsliste enthalten ist.

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

$x = New-CsBlockedDomain -Identity "fabrikam.com" -InMemory
$x.Comment = "Blocked per Ken Myer."
Set-CsBlockedDomain -Instance $x

In Beispiel 2 wird dargestellt, wie Sie mit dem Parameter "InMemory" eine neue blockierte Domäne erstellen können, die anfangs nur im Arbeitsspeicher vorhanden ist. Nachdem Sie die Eigenschaftswerte für diese Domäne geändert haben, die sich nur im Arbeitsspeicher befindet, können Sie das Cmdlet Set-CsBlockedDomain aufrufen, um die Domäne der Blockierliste hinzuzufügen.

Dazu wird in der ersten Zeile des Befehls mithilfe des Cmdlets New-CsBlockedDomain und des Parameters "InMemory" eine blockierte Domäne mit der Identität "fabrikam.com" erstellt. Beim Erstellen wird diese virtuelle Domäne in der Variablen "$x" gespeichert.

In der zweiten Zeile wird die Eigenschaft "Comment" der virtuellen Domäne geändert. Anschließend wird in der dritten Zeile das Cmdlet Set-CsBlockedDomain verwendet, um die virtuelle Domäne der Blockierliste hinzuzufügen. Ohne die dritte Zeile wäre die virtuelle Domäne nur im Arbeitsspeicher vorhanden und würde der Blockierliste niemals hinzugefügt. Stattdessen geht die virtuelle Domäne verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.