Set-CsDirector
Letztes Änderungsdatum des Themas: 2012-03-27
Ändert die Eigenschaften eines oder mehrerer Directors. Directors können zum Authentifizieren von Benutzeranforderungen, jedoch nicht zum Hosten von Benutzerkonten verwendet werden.
Syntax
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Der Director authentifiziert Benutzer und reagiert auf Benutzeranforderungen, ohne eigentlich Benutzerkonten zu hosten. Directors werden typischerweise für Organisationen verwendet, die einen externen Zugriff auf das Netzwerk über Edgeserver zulassen. In diesem Szenario verringern Directors nicht nur die Last der Front-End-Server (durch die Verarbeitung von Authentifizierungsanforderungen), sondern schützen das interne Netzwerk zusätzlich vor Denial-of-Service-Angriffen und anderem bösartigen Datenverkehr. Directors sind zudem nützlich, wenn mehrere Front-End-Server an einem zentralen Standort bereitgestellt werden. In diesem Fall empfangen Directors sämtliche Benutzeranforderungen und übermitteln diese an den entsprechenden Serverpool. So wird die Last der Front-End-Server weiterhin reduziert.
Mit dem Cmdlet Set-CsDirector können die Eigenschaftswerte aller gegenwärtig in der Organisation verwendeten Directors geändert werden. Dies umfasst u. a. das Ändern des dem Director zugeordneten Archivierungsservers oder Edgeservers sowie das Ändern des für das Senden und Empfangen von SIP-Datenverkehr verwendeten Ports.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsDirector lokal ausfü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-CsDirector"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Dienstidentifizierung des zu ändernden Directors. Beispiel: -Identity "Director:atl-cs-001.litwareinc.com". Beachten Sie, dass Sie das Präfix "Director:" auslassen können, wenn Sie einen Director angeben. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Archivierungsservers, der dem Director zugeordnet werden soll. Beispiel: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
EdgeServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Edgeservers, der dem Director zugeordnet werden soll. Beispiel: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Monitoring Servers, der dem Director zugeordnet werden soll. Beispiel: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
SipPort |
Optional |
Ganze Zahl |
Port für den SIP-Datenverkehr (Session Initiation Protocol). |
SipHealthPort |
Optional |
Ganze Zahl |
Port für die Überwachung der Serverintegrität. |
SipServerTcpPort |
Optional |
Ganze Zahl |
SIP-Überwachungsport. Der Standardwert ist 5060. |
WebPort |
Optional |
Ganze Zahl |
Port für die Kommunikation mit Webdiensten. |
WebServer |
Optional |
Zeichenfolge |
Dienstidentifizierung der Webdienste des Servers, der dem Director zugeordnet werden soll. Beispiel: -WebServer "WebServer:atl-cs-001.litwareinc.com" |
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
Keine. Set-CsDirector akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Das Cmdlet Set-CsDirector gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayDirector" geändert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
Über den Befehl in Beispiel 1 wird der dem Director "Director:atl-cs-001.litwareinc.com" zugeordnete Archivierungsserver geändert. In diesem Beispiel wird der Archivierungsserver in "ArchivingServer:dublin-cs-001.litwareinc.com" geändert.
-------------------------- Beispiel 2 ------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
Über den vorstehenden Befehl wird der SIP-Port für alle gegenwärtig in der Organisation verwendeten Directors geändert. Dazu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "Director", um eine Auflistung aller Directors innerhalb der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet ForEach-Object weitergeleitet. ForEach-Object führt Set-CsDirector für jeden Standort in der Auflistung aus und ändert den Wert der Eigenschaft "SipPort" auf 5072.