Set-CsBlockedDomain
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert die Eigenschaft "Comment" für eine oder mehrere Domänen, die in der Liste der für den Partnerverbund blockierten Domänen enthalten sind. 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
Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 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 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.
Die Eigenschaft "Comment" – die einzige Eigenschaft einer blockierten Domäne, die geändert werden kann – wird zum Speichern zusätzlicher Informationen zu einer Domäne in der Blockierliste verwendet (z. B. Informationen dazu, warum diese blockiert ist, wann sie aus der Blockierliste entfernt werden kann oder an wen sich Benutzer wenden müssen, um die Domäne aus der Blockierliste zu entfernen). Verwenden Sie das Cmdlet Set-CsBlockedDomain, wenn Sie die Eigenschaft "Comment" für eine beliebige Domäne in der Liste blockierter Domänen ändern möchten.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-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 "Set-CsBlockedDomain"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) der blockierten Domäne für die die Eigenschaft "Comment" geändert wird. Beispiel: fabrikam.com |
Instance |
Optional |
BlockedDomain-Objekt |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
Comment |
Optional |
Zeichenfolge |
Ermöglicht Ihnen die Bereitstellung zusätzlicher Informationen zur Domäne, die geändert werden soll. Sie können beispielsweise einen Kommentar hinzufügen, der darüber informiert, warum die Domäne in der Blockierliste aufgenommen wurde. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
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.WritableConfig.Settings.Edge.BlockedDomain-Objekt. Das Cmdlet Set-CsBlockedDomain akzeptiert weitergeleitete Instanzen des Objekts für blockierte Domänen.
Rückgabetypen
Set-CsBlockedDomain gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."
Der Befehl in Beispiel 1 ändert den Kommentar zu der blockierten Domäne mit dem Identitätswert "fabrikam.com". In diesem Beispiel wird der Parameter "Comment" zusammen mit dem Parameterwert "Block this domain pending legal review." verwendet.
-------------------------- Beispiel 2 --------------------------
Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."
Im vorstehenden Beispiel wird die Eigenschaft "Comment" für alle in der Liste blockierter Domänen enthaltenen Domänen aktualisiert. Hierzu ruft der Befehl zunächst das Cmdlet Get-CsBlockedDomain auf, das eine Auflistung aller derzeit in der Liste blockierter Domänen enthaltenen Domänen zurückgibt. Diese Auflistung wird dann an Set-CsBlockedDomain weitergeleitet, das die Eigenschaft "Comment" für jede Domäne in der Auflistung ändert.
-------------------------- Beispiel 3 --------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."
In Beispiel 3 wird jeder Domäne in der Blockierliste, für die noch kein Wert für die Eigenschaft "Comment" konfiguriert wurde, ein neuer Kommentar hinzugefügt ("Block this domain pending legal review."). Hierzu ruft der Befehl zunächst Get-CsBlockedDomain auf, um eine Auflistung aller derzeit 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" einen Nullwert aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsBlockedDomain weitergeleitet, das denselben Kommentar der Eigenschaft "Comment" jeder Domäne in der gefilterten Auflistung zuweist.
Siehe auch
Weitere Ressourcen
Get-CsBlockedDomain
New-CsBlockedDomain
Remove-CsBlockedDomain
Set-CsAccessEdgeConfiguration