Freigeben über

Konfigurieren der Workflowhostverwaltung mithilfe von Windows Server AppFabric-Cmdlets

  • Artikel

In diesem Thema wird die Konfiguration hostingbezogener Features mithilfe von AppFabric Windows PowerShell-Cmdlets beschrieben.

Konfigurieren des Features zum Entladen von Instanzen mithilfe von Cmdlets

In diesem Abschnitt wird die Verwendung von AppFabric-Cmdlets zum Abrufen, Festlegen oder Löschen von Konfigurationselementen und -attributen im Zusammenhang mit dem Feature zum Entladen von Instanzen in der dem angegebenen Geltungsbereich zugeordneten Konfiguration beschrieben. Das Feature zum Entladen von Instanzen ermöglicht Ihnen, anzugeben, ob und wann die Workflowdienstinstanzen persistent fortgeführt und entladen werden.

Cmdlet

Beschreibung

Get-ASInstanceUnloadPolicy

Ruft die Werte der Attribute timeToUnload und timeToPersist des workflowIdle-Elements in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei ab.

Set-ASInstanceUnloadPolicy

Legt die Werte der Attribute timeToUnload und timeToPersist des workflowIdle-Elements in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei fest. Wenn das workflowIdle-Element nicht vorhanden ist, fügt das Cmdlet das Element hinzu und legt den Wert der Attribute timeToUnload und timeToPersist für das Element fest. Wenn nur einer dieser zwei Parameter übergeben wird, wird das dem anderen Parameter entsprechende Attribut auf 00:00:00 festgelegt.

Clear-ASInstanceUnloadPolicy

Entfernt das workflowIdle-Element aus der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei.

Syntaxoptionen für das Cmdlet „Get-ASInstanceUnloadPolicy“

// to get instance unload policy settings at the root level
Get-ASInstanceUnloadPolicy -Root

// to get instance unload policy settings at the Web site level
Get-ASInstanceUnloadPolicy -SiteName <String> 

// to get instance unload policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <String>] 

// to get instance unload policy settings at the site, virtual application or service level that the Uri points to
Get- ASInstanceUnloadPolicy -Uri <Uri> 

// to get instance unload policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceUnloadPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceUnloadPolicy

// to get instance unload policy settings at the service level specified by the Service Object
Get-ASInstanceUnloadPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceUnloadPolicy

Syntaxoptionen für das Cmdlet „Set-ASInstanceUnloadPolicy“

Set-ASInstanceUnloadPolicy –Root –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy -SiteName <String> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <string> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –Uri <Uri> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –ApplicationObject <ApplicationInfo> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –ServiceObject <ServiceInfo> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Spezifische Parameter des Cmdlets „Set-ASInstanceUnloadPolicy“

Parameter

Beschreibung

TimeToUnload

Gibt an, wie lange ein Diensthost vor dem Entladen einer Workflowdienstinstanz warten soll, nachdem die Instanz in den Leerlauf versetzt wurde.

TimeToPersist

Gibt an, wie lange ein Diensthost vor dem persistenten Fortführen einer Workflowdienstinstanz warten soll, nachdem die Instanz in den Leerlauf versetzt wurde.

Hinweis

Sie müssen nur die Parameter übergeben, die Sie ändern möchten. Wenn Sie z. B. einen Wert für das Attribut timeToUnload festlegen möchten, übergeben Sie nur den Parameter TimeToUnload.

Syntaxoptionen für das Cmdlet „Clear-ASInstanceUnloadPolicy“

Clear-ASInstanceUnloadPolicy -Root

Clear-ASInstanceUnloadPolicy -SiteName <String> 

Clear-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <String>] 

Clear- ASInstanceUnloadPolicy -Uri <Uri> 

Clear-ASInstanceUnloadPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Clear-ASInstanceUnloadPolicy

Clear-ASInstanceUnloadPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Clear-ASInstanceUnloadPolicy

Konfigurieren der Instanzausnahmerichtlinie mithilfe von Cmdlets

Die folgenden Cmdlets können verwendet werden:

Cmdlet

Beschreibung

Get-ASInstanceExceptionPolicy

Ruft den Wert des Attributs action der Ausnahme workflowUnhandledException aus der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei ab.

Set-ASInstanceExceptionPolicy

Legt den Wert des Attributs action der Ausnahme workflowUnhandledException in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei fest. Das Cmdlet erstellt das Element, wenn das Element noch nicht vorhanden ist und legt dann das Attribut action des Elements fest.

Clear-ASInstanceExceptionPolicy

Entfernt das workflowUnhandledException-Element aus der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei.

Syntaxoptionen für das Cmdlet „Get-ASInstanceExceptionPolicy“

// to get instance exception policy settings at the root level
Get-ASInstanceExceptionPolicy -Root

// to get instance exception policy settings at the Web site level
Get-ASInstanceExceptionPolicy -SiteName <String> 

// to get instance exception policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <String>] 

// to get instance exception policy settings at the site, virtual application or service level that the Uri points to
Get-ASInstanceExceptionPolicy -Uri <Uri> 

// to get instance exception policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceExceptionPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceExceptionPolicy

// to get instance exception policy settings at the service level specified by the Service Object
Get-ASInstanceExceptionPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceExceptionPolicy

Warnung

Im IIS-Manager wird AbandonAndSuspend als Wert dieses Felds angezeigt, wenn kein zugeordnetes workflowUnhandledException-Element in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei vorhanden ist. Dieses Cmdlet gibt jedoch keinen Wert zurück, wenn in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei kein workflowUnhandledException-Element vorhanden ist.

Syntaxoptionen für das Cmdlet „Set-ASInstanceExceptionPolicy“

Set-ASInstanceExceptionPolicy –Root –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy -SiteName <String> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <string> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –Uri <Uri> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –ApplicationObject <ApplicationInfo> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –ServiceObject <ServiceInfo> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Spezifische Parameter des Cmdlets „Set-ASInstanceExceptionPolicy“

Parameter

Beschreibung

Aktion

Gibt an, welche Aktion ein Diensthost ausführen soll, wenn bei einer von ihm ausgeführten Workflowdienstinstanz ein Ausnahmefehler auftritt.

  • Verwerfen. Der Diensthost gibt die Workflowdienstinstanz im Arbeitsspeicher auf. Der Status der Instanz in der Datenbank bleibt „Aktiv“. Der Workflowverwaltungsdienst stellt die verworfene Workflowinstanz aus dem zuletzt in der Persistenzdatenbank gespeicherten Persistenzpunkt wieder her.

  • Verwerfen und Anhalten. Der Diensthost gibt die Workflowdienstinstanz im Arbeitsspeicher auf und legt den Status der Instanz in der Persistenzdatenbank auf „Angehalten“ fest. Eine angehaltene Workflowdienstinstanz kann zu einem späteren Zeitpunkt mithilfe von IIS-Manager fortgesetzt oder beendet werden. Diese Workflowdienstinstanzen werden vom Workflowverwaltungsdienst nicht automatisch wiederhergestellt.

  • Beenden. Der Diensthost gibt die Workflowdienstinstanz im Arbeitsspeicher auf und legt den Status der Instanz in der Persistenzdatenbank auf „Abgeschlossen (Beendet)“ fest. Eine beendete Workflowdienstinstanz kann nicht zu einem späteren Zeitpunkt fortgesetzt werden.

  • Abbrechen. Der Diensthost bricht die Workflowdienstinstanz ab. Dadurch werden alle Abbruchhandler aufgerufen, sodass ein Workflow ordnungsgemäß beendet wird. Anschließend legt der Diensthost den Status der Instanz in der Persistenzdatenbank auf „Abgeschlossen (Abgebrochen)“ fest.

Syntaxoptionen für das Cmdlet „Clear-ASInstanceExceptionPolicy“

Clear-ASInstanceExceptionPolicy -Root

Clear-ASInstanceExceptionPolicy -SiteName <String> 

Clear-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <String>] 

Clear-ASInstanceExceptionPolicy -Uri <Uri> 

Clear-ASInstanceExceptionPolicy -ApplicationObject <ApplicationInfo> 

Clear-ASInstanceExceptionPolicy -ServiceObject <ServiceInfo>

Konfigurieren der Instanzverwaltungsrichtlinie mithilfe von Cmdlets

Die folgenden Cmdlets können verwendet werden:

Cmdlet

Beschreibung

Get-ASInstanceManagement

Ruft den Wert des Attributs authorizedWindowsGroup des Elements workflowInstanceManagement aus der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei ab.

Set-ASInstanceManagement

Legt den Wert des Attributs authorizedWindowsGroup des Elements workflowInstanceManagement in der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei fest. Das Cmdlet erstellt das Element, wenn das Element noch nicht vorhanden ist und legt dann das Attribut action des Elements fest.

Clear-ASInstanceManagement

Entfernt das workflowInstanceManagement-Element aus der dem angegebenen Geltungsbereich zugeordneten Konfigurationsdatei. Das Cmdlet fügt der Konfigurationsdatei darüber hinaus <remove name="workflowInstanceManagement" /> hinzu.

Syntaxoptionen für das Cmdlet „Get-ASInstanceManagement“

// to get instance management policy settings at the root level
Get-ASInstanceManagement -Root

// to get instance management policy settings at the Web site level
Get-ASInstanceManagement -SiteName <String> 

// to get instance management policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceManagement -SiteName <String> -VirtualPath <String>] 

// to get instance management policy settings at the site, virtual application or service level that the Uri points to
Get-ASInstanceManagement -Uri <Uri> 

// to get instance management policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceManagement -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceManagement

// to get instance management policy settings at the service level specified by the Service Object
Get-ASInstanceManagement -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceManagement

Syntaxoptionen für das Cmdlet „Set-ASInstanceManagement“

Set-ASInstanceManagement –Root –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement -SiteName <String> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –AuthorizedWindowsGroup <String>}
Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –Root –EnableNetPipeProtocol
Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –AuthorizedWindowsGroup <String>} –Root –EnableNetPipeProtocol

Set-ASInstanceManagement –Uri <Uri> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement –ApplicationObject <ApplicationInfo> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement –ServiceObject <ServiceInfo> –AuthorizedWindowsGroup <String>}

Syntaxoptionen für das Cmdlet „Clear-ASInstanceManagement“

Clear-ASInstanceManagement -Root

Clear-ASInstanceManagement -SiteName <String> 

Clear-ASInstanceManagement -SiteName <String> -VirtualPath <String>] 

Clear-ASInstanceManagement -Uri <Uri> 

Clear-ASInstanceManagement -ApplicationObject <ApplicationInfo> 

Clear-ASInstanceManagement -ServiceObject <ServiceInfo>

  2011-12-05