Konfigurieren der Nachverfolgung

In diesem Thema wird beschrieben, wie AppFabric-Cmdlets zum Konfigurieren der Nachverfolgung für eine Webanwendung oder einen Dienst verwendet werden können. Die Cmdlets, die Sie zum Konfigurieren der Nachverfolgung verwenden können, sind Import-ASAppServiceTrackingProfile, Get-ASAppServiceTracking, Remove-ASAppServiceTrackingProfile und Get-ASAppServiceTrackingProfile.

Wenn Sie ein AppFabric-Cmdlet interaktiv ausführen möchten, öffnen Sie die Windows PowerShell-Konsole für AppFabric, geben das entsprechende Cmdlet ein und drücken dann die EINGABETASTE. Weitere Informationen zum Ausführen von Cmdlets finden Sie unter Ausführen von AppFabric-Cmdlets.

So importieren Sie Nachverfolgungsinformationen für eine Webanwendung

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Import-ASAppServiceTrackingProfile aus, um Nachverfolgung zu konfigurieren, die zum Überwachen von Dienstvorgängen verwendet wird. Dieses Cmdlet importiert ein Nachverfolgungsprofil aus der angegebenen Datei in die Zielkonfigurationsdatei der angegebenen Ebene. Das Ziel (der Bereich) dieses Vorgangs kann die Datei Machine.config des Computers sein, die Datei Web.config im Stammverzeichnis oder eine Datei Web.config mit einem Pfad, der durch die Site, die Webanwendung, das virtuelle Anwendungsverzeichnis, den Dienst oder die Dienstinstanz angegeben wird. Wenn ein Dienst angegeben wird, muss es sich um einen SVC-, einen XAMLS- oder XOML-Dienst handeln.

Syntaxoptionen für Import-ASAppServiceTrackingProfile:

Syntax 1

Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath] <String> [-Overwrite] [-ProfileName <String>]

Syntax 2

Import-ASAppServiceTrackingProfile [-Uri] <Uri> [-FilePath] <String> [-Overwrite] [-ProfileName <String>]

Syntax 3

Import-ASAppServiceTrackingProfile [-FilePath] <String> -ApplicationObject <ApplicationInfo> [-Overwrite] [-ProfileName <String>]

Syntax 4

Import-ASAppServiceTrackingProfile [-FilePath] <String> -ServiceObject <ServiceInfo> [-Overwrite] [-ProfileName <String>]

Syntax 5

Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo>, -ServiceObject <DienstInfo> oder -Root	Betriebsbereich des Cmdlets.
[-FilePath] <Zeichenfolge>	Gibt den Namen der Datei (einschließlich Pfad) an, aus der das Nachverfolgungsprofil importiert werden soll. Dieser Parameter ist erforderlich. Der Datei muss genau ein Profil enthalten.
[-Overwrite]	Optional. Wenn dieser Parameter angegeben wird, werden alle vorhandenen Nachverfolgungsprofilkonfigurationen überschrieben. Das Verhalten entspricht dem Aufruf von Remove-TrackingProfile, gefolgt von Import-TrackingParticipant ohne das Kennzeichen -overwrite. Es tritt ein Fehler des Cmdlets auf, wenn das Nachverfolgungsprofil nicht entfernt werden kann.
[-ProfileName <Zeichenfolge>]	Gibt den Namen an, der dem importierten Nachverfolgungsprofil zugewiesen werden soll. Der Parameter gibt das Namensattribut des Profilelements an. Dieser Parameter ist optional. Wenn er angegeben wird, setzt dieser Parameter den in der Datei angegebenen Namen außer Kraft.

So rufen Sie Nachverfolgungsinformationen für eine Webanwendung ab

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Get-ASAppServiceTracking aus, um die aktuellen Nachverfolgungseinstellungen für einen Dienst mithilfe eines Objekts ServiceTrackingInfo abzurufen, das die aktuellen Nachverfolgungseinstellungen für den Dienst beschreibt. Das Objekt enthält eine Liste der Nachverfolgungskomponenten, die für den Dienst aktiviert sind, sowie ein Kennzeichen, das angibt, ob Nachverfolgung für den Dienst aktiviert ist. Das Ziel (der Bereich) dieses Vorgangs ist die Datei Web.config, die einem Dienst (oder einer Dienstinstanz) zugeordnet ist.

Syntaxoptionen für Get-ASAppServiceTracking:

Syntax 1

Get-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>]

Syntax 2

Get-ASAppServiceTracking [-Uri] <Uri>

Syntax 3

Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>

Syntax 4

Get-ASAppServiceTracking -ServiceObject <ServiceInfo>

Syntax 5

Get-ASAppServiceTracking -Root

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo>, -ServiceObject <DienstInfo> oder -Root	Betriebsbereich des Cmdlets.

So legen Sie Nachverfolgungsinformationen für eine Webanwendung fest

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Set-AsAppServiceTracking aus, um die Nachverfolgungsinformationen für die Webanwendung im angegebenen Bereich festzulegen.

Syntaxoptionen für Set-AsAppServiceTracking:

Syntax 1

Set-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>

Syntax 2

Set-ASAppServiceTracking [-Uri] <Uri> -ProfileName <String>

Syntax 3

Set-ASAppServiceTracking -ApplicationObject <ApplicationInfo> -ProfileName <String>

Syntax 4

Set-ASAppServiceTracking -ProfileName <String> -ServiceObject <ServiceInfo>

Syntax 5

Set-ASAppServiceTracking -ProfileName <String> -Root

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath], [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo> oder -Root	Betriebsbereich des Cmdlets.
-ProfileName	Der Name des Profils, das die festzulegenden Nachverfolgungsinformationen enthält.

So entfernen Sie Nachverfolgungsinformationen für eine Webanwendung

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Remove-ASAppServiceTrackingProfile aus, um ein Nachverfolgungsprofil aus der angegebenen Konfigurationsebene zu entfernen. Dieses Cmdlet wird zum Konfigurieren der Nachverfolgung verwendet, die der Überwachung der Dienstvorgänge dient.

Syntaxoptionen für Remove-ASAppServiceTrackingProfile:

Syntax 1

Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>

Syntax 2

Remove-ASAppServiceTrackingProfile [-Uri] <Uri> -ProfileName <String>

Syntax 3

Remove-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> -ProfileName <String>

Syntax 4

Remove-ASAppServiceTrackingProfile -ProfileName <String> -ServiceObject <ServiceInfo>

Syntax 5

Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo>, -ServiceObject <DienstInfo> oder -Root	Betriebsbereich des Cmdlets.
-ProfileName <Zeichenfolge>	Gibt den Namen des zu entfernenden Nachverfolgungsprofils an. Das Profil muss lokal in der Zielkonfigurationsdatei definiert sein. Dieser Parameter ist erforderlich.

So rufen Sie ein Nachverfolgungsprofil für eine Webanwendung ab

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Get-ASAppServiceTrackingProfile aus, um die für einen Dienst sichtbaren Nachverfolgungsprofile in einer Klasse TrackingProfileInfo zurückzugeben (dies schließt Profile ein, die in allen Bereichen definiert sind). Alle Einstellungen in der Konfigurationshierarchie der Zielkonfigurationsdatei liegen für diesen Vorgang im Bereich. Dies bedeutet, dass sowohl lokale (in der Zieldatei definierte) als auch vererbte (in der Datei Machine.config oder der Datei Web.config des Stammverzeichnisses definierte) Einstellungen zurückgegeben werden können.

Syntaxoptionen für Get-ASAppServiceTrackingProfile:

Syntax 1

Get-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-ProfileName <String>]

Syntax 2

Get-ASAppServiceTrackingProfile [-Uri] <Uri> [-ProfileName <String>]

Syntax 3

Get-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> [-ProfileName <String>]

Syntax 4

Get-ASAppServiceTrackingProfile -ServiceObject <ServiceInfo> [-ProfileName <String>]

Syntax 5

Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo>, -ServiceObject <DienstInfo> oder -Root	Betriebsbereich des Cmdlets.
-ProfileName <Zeichenfolge>	Gibt den Namen des zurückzugebenden Nachverfolgungsprofils an. Das Profil kann lokal in der Zielkonfigurationsdatei definiert oder von seiner Konfigurationsdateihierarchie vererbt sein. Dieser Parameter ist optional. Wenn der Parameter ProfileName nicht angegeben wird, werden alle der Zielkonfigurationsdatei zugeordneten Nachverfolgungsprofile (lokale und vererbte Profile) zurückgegeben.

  2012-03-05