• Artikel

Get-CsDiagnosticHeaderConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den derzeit in Ihrer Organisation verwendeten Konfigurationseinstellungen für Diagnoseheader zurück. Mit den Konfigurationseinstellungen für Diagnoseheader wird bestimmt, ob SIP-Nachrichten von Headerinformationen begleitet werden. Diese Informationen können bei der Problembehandlung und Fehlerberichterstattung nützlich sein.

Syntax

Get-CsDiagnosticHeaderConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Detaillierte Beschreibung

Beim Senden von SIP-Nachrichten (Session Initiation Protocol) haben Sie die Möglichkeit, jeder Nachricht einen Header vom Typ "ms-diagnostics" anzufügen. Diese Nachricht (die Endbenutzern nicht angezeigt wird) enthält Informationen, die bei der Behandlung von Verbindungsproblemen oder in Fehlerberichten nützlich sein können. Der Diagnoseheader kann beispielsweise Fehlercodes enthalten, die es der Clientanwendung (z. B. Microsoft Lync 2010) ermöglichen, vordefinierte Aktionen auszuführen, sollte eine bestimmte Situation eintreten.

Bei innerhalb in Ihrem internen Netzwerk gesendeten SIP-Nachrichten gibt es keinen Grund, diese Diagnoseheader nicht zu verwenden: Sie haben kaum Einfluss auf die Nachrichtengröße und sind ein unschätzbares Tool für Administratoren bei der Behebung von Verbindungsproblemen. Diagnoseheader enthalten jedoch auch Informationen, z. B. die vollqualifizierten Domänennamen Ihrer SIP-Server (FQDNs), die Sie gegebenenfalls anderen Personen außerhalb des internen Netzwerks zur Verfügung stellen möchten. Aus diesem Grund können Sie in den Konfigurationseinstellungen für Diagnoseheader festlegen, ob Diagnoseheader an Empfänger in externen Netzwerken (z. B. Benutzern in einer Partnerdomäne) und/oder externe Benutzer gesendet werden sollen. (Externe Benutzer sind Benutzer, die sich von außerhalb des internen Netzwerks verbinden und noch nicht authentifiziert wurden.)

Standardmäßig werden Nachrichten, die entweder an externe Netzwerke oder an nicht authentifizierte Benutzer gesendet werden, keine Header hinzugefügt. Sie können jedoch die globalen Einstellungen für Diagnoseheader so ändern, dass Header an externe Netzwerke und/oder nicht authentifizierte Benutzer gesendet werden. Alternativ können Sie benutzerdefinierte Einstellungen auf Standort- oder Dienstebene (entweder für den Edgeserver oder für den Registrierungsdienst) erstellen. Auf diese Weise können Sie bestimmen, dass Diagnoseheader Nachrichten hinzugefügt werden, die von einem Standort oder über einen einzelnen Edgeserver gesendet werden, während Nachrichten, die von anderen Standorten oder über andere Edgeserver gesendet werden, keine Header hinzugefügt werden sollen.

Mit dem Cmdlet Get-CsDiagnosticHeaderConfiguration können Sie Informationen zu den Konfigurationseinstellungen für Diagnoseheader abrufen, die derzeit in Ihrer Organisation verwendet werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsDiagnosticHeaderConfiguration lokal ausfü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-CsDiagnosticHeaderConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID für die Konfigurationseinstellungen für Diagnoseheader, die abgerufen werden sollen. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zurückzugeben: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Identity "service:EdgeServer:atl-edge-001.litwareinc.com". Verwenden Sie diese Syntax, um die globalen Einstellungen zurückzugeben: -Identity global.

Wenn dieser Parameter nicht festgelegt ist, werden alle derzeit verwendeten Konfigurationseinstellungen für Diagnoseheader zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Festlegen der Einstellungsauflistung (oder Auflistungen), die zurückgegeben werden soll. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter "site:*". Verwenden Sie folgende Syntax, um alle auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Filter "service:*".

Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht im gleichen Befehl verwenden können.

LocalStore

Optional

Switch-Parameter

Ruft die Konfigurationsdaten für Diagnoseheader aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsDiagnosticHeaderConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsDiagnosticHeaderConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings" zurückgegeben.

Beispiel

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

Get-CsDiagnosticHeaderConfiguration

Mit dem vorstehenden Befehl werden Informationen zu allen derzeit in Ihrer Organisation verwendeten Konfigurationseinstellungen für Diagnoseheader zurückgegeben. Dazu wird Get-CsDiagnosticHeaderConfiguration ohne Parameter aufgerufen.

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

Get-CsDiagnosticHeaderConfiguration -Identity site:Redmond

In Beispiel 2 wird nur eine Auflistung von Konfigurationseinstellungen für Diagnoseheader zurückgegeben: die Auflistung mit dem Identitätswert "site:Redmond".

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

Get-CsDiagnosticHeaderConfiguration -Filter "service:*"

Der Befehl in Beispiel 3 gibt alle Diagnoseheadereinstellungen zurück, die auf Dienstebene konfiguriert wurden. Dazu werden Get-CsDiagnosticHeaderConfiguration und der Parameter "Filter" aufgerufen. Mit dem Filterwert "service:*" wird sichergestellt, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit den Zeichen "service:" beginnt.

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True}

In Beispiel 4 werden alle Konfigurationseinstellungen für Diagnoseheader zurückgegeben, die das Senden an externe Netzwerke zulassen. Hierzu ruft der Befehl zunächst Get-CsDiagnosticHeaderConfiguration ohne Parameter auf. Damit wird eine Auflistung aller derzeit verwendeten Diagnoseheadereinstellungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "SendToExternalNetworks" den Wert "True" aufweist.

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True -or $_.SendToOutsideUnauthenticatedUsers -eq $True}

Der Befehl in Beispiel 5 gibt Informationen zu den Konfigurationseinstellungen für Diagnoseheader zurück, die mindestens eines der folgenden Kriterien erfüllen: 1) die Eigenschaft "SendToExternalNetworks" ist gleich "True" und/oder 2) die Eigenschaft "SendToOutsideUnauthenticatedUsers" ist gleich "True". Hierzu verwendet der Befehl zunächst Get-CsDiagnosticHeaderConfiguration, um eine Auflistung aller derzeit verwendeten Diagnoseheadereinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "SendToExternalNetworks" bzw. "SendToOutsideUnauthenticatedUsers" den Wert "True" aufweist.

Mit dem Vergleichsoperator "-or" wird festgelegt, dass die zurückzugebenden Einstellungen nur eines der festgelegten Kriterien erfüllen müssen. Wenn Einstellungen zurückgegeben werden sollen, die beide festgelegten Kriterien erfüllen, muss der Vergleichsoperator "-and" verwendet werden:

Where-Object {$_.SendToExternalNetworks -eq $True -and $_.SendToOutsideUnauthenticatedUsers -eq $True}