Set-ASInstanceUnloadPolicy

Set-ASInstanceUnloadPolicy

指定されたスコープでインスタンス アンロード ポリシーを設定します。

構文

Parameter Set: SiteNameAndVirtualPath
Set-ASInstanceUnloadPolicy [-SiteName] <String> [[-VirtualPath] <String> ] [-TimeToPersist <TimeSpan> ] [-TimeToUnload <TimeSpan> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ApplicationObject
Set-ASInstanceUnloadPolicy -ApplicationObject <ApplicationInfo> [-TimeToPersist <TimeSpan> ] [-TimeToUnload <TimeSpan> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: RootConfig
Set-ASInstanceUnloadPolicy [-Root] [-TimeToPersist <TimeSpan> ] [-TimeToUnload <TimeSpan> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ServiceObject
Set-ASInstanceUnloadPolicy -ServiceObject <ServiceInfo> [-TimeToPersist <TimeSpan> ] [-TimeToUnload <TimeSpan> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Uri
Set-ASInstanceUnloadPolicy [-Uri] <Uri> [-TimeToPersist <TimeSpan> ] [-TimeToUnload <TimeSpan> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細な説明

Set-ASInstanceUnloadPolicy コマンドレットは、workflowIdle 要素を追加し (まだ存在しない場合)、この要素の timeToUnload 属性と timeToPersist 属性の値を設定します。

このコマンドレットと共に -UseInherited パラメーターを使用すると、指定されたスコープについて関連付けのある workflowIdle 要素または <remove name="workflowIdle"> 要素がすべて削除され、workflowIdle ビヘイビアー設定が上位のスコープから継承されるようになります。

パラメーター

-ApplicationObject<ApplicationInfo>

ApplicationObject の名前。コマンドレットは、そのアプリケーションに対して動作します。このパラメーターは、Get-ASApplication コマンドレットの出力を、ApplicationObject パラメーターを含むコマンドレットにパイプするために使用します。

エイリアス

なし

必須

true

位置

named

既定値

なし

パイプライン入力の許可

true (ByValue)

ワイルドカード文字の許可

-Root

ルート アプリケーションの名前。コマンドレットは、そのスコープで動作します。Root パラメーターを使用する場合は、SiteName、VirtualPath、または Uri パラメーターを使用しないでください。

エイリアス

なし

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

ワイルドカード文字の許可

-ServiceObject<ServiceInfo>

ServiceObject の名前。コマンドレットは、そのサービスに対して動作します。このパラメーターは、通常、Get-ASAppService コマンドレットの出力を、ServiceObject パラメーターを含むコマンドレットにパイプするために使用します。

エイリアス

なし

必須

true

位置

named

既定値

なし

パイプライン入力の許可

true (ByValue)

ワイルドカード文字の許可

-SiteName<String>

Web サイトの名前を、IIS マネージャーの [接続] ウィンドウで定義されているとおりに指定します。コマンドレットは、そのサイトのスコープで動作するか、そのサイト内の特定のアプリケーション、仮想ディレクトリ、またはサービスのスコープで動作します。SiteName パラメーターを使用する場合は、そのサイト内に存在するアプリケーション、ディレクトリ、またはサービスを指定する VirtualPath パラメーターを追加する必要があります。

アプリケーションまたは仮想ディレクトリの場合は、IIS で定義されているとおりのアプリケーションの名前が仮想パスに含まれます。サービスの場合、仮想パスにはアプリケーションの名前、スラッシュ、およびサービスの .svc ファイルまたは .xamlx ファイルの名前が含まれます。VirtualPath パラメーターは、サイト スコープの場合は必要ありません。仮想パスの先頭の "/" 文字は省略可能です。SiteName パラメーターを使用する場合は、Uri パラメーターを使用しないでください。

エイリアス

なし

必須

true

位置

1

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

ワイルドカード文字の許可

-TimeToPersist<TimeSpan>

ワークフロー サービス インスタンスがアイドル状態を維持する期間を指定します。その後、ホストはインスタンスを永続化データベースに保持します。値は、hh:mm:ss:mmm の形式の時間値です。このパラメーターの既定値は TimeSpan.MaxValue 秒です。

このパラメーターの値を TimeSpan.MaxValue に設定すると、ランタイムはアイドルになったワークフロー インスタンスを保持しません。この値を 0 に設定した場合、ホストはインスタンスがアイドル状態になったらすぐにインスタンスを永続化します。

また、timeToPersist と timeToUnload の値を両方指定する場合、保持タイムアウトの値はアンロード タイムアウトの値より小さい必要があります。そうしないと、インスタンスが永続化されません。

エイリアス

なし

必須

false

位置

named

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

ワイルドカード文字の許可

-TimeToUnload<TimeSpan>

ワークフロー サービス インスタンスがアイドル状態を維持する期間を指定します。その後、ホストはメモリからインスタンスをアンロードし、インスタンスの状態情報を永続化データベースに保持します。

値は、hh:mm:ss:mmm の形式の時間値です。このパラメーターの既定値は 60 秒です。この値を 0 に設定した場合、ホストはインスタンスがアイドル状態になったらすぐにインスタンスをアンロードし、永続化します。許可される最大値は TimeSpan.MaxValue です。

エイリアス

なし

必須

false

位置

named

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

ワイルドカード文字の許可

-Uri<Uri>

IIS サイト、アプリケーション、仮想ディレクトリ、またはサービスの URI。コマンドレットは、そのスコープで動作します。Uri パラメーターを使用する場合は、SiteName パラメーターまたは SiteName パラメーターと VirtualPath パラメーターのセットを使用しないでください。

エイリアス

なし

必須

true

位置

1

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

ワイルドカード文字の許可

-UseInherited

上位スコープから設定を継承するには、このパラメーターを使用します。このパラメーターを使用すると、指定したレベルで定義されている workflowIdle のビヘイビアーはすべて削除されます。

また、このコマンドレットは、指定されたスコープについて関連付けのある <remove name="workflowIdle"> 要素をすべて削除します。

エイリアス

なし

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

ワイルドカード文字の許可

-VirtualPath<String>

アプリケーション、仮想ディレクトリ、またはサービスの仮想パスを、IIS マネージャーの [接続] ウィンドウで定義されているとおりに指定します。コマンドレットは、そのアプリケーション、仮想ディレクトリ、またはサービスに対して動作します。VirtualPath パラメーターは SiteName パラメーターと共に使用する必要があります。SiteName では、アプリケーション、ディレクトリ、またはサービスが存在するサイトを指定します。仮想パスの先頭の "/" 文字は省略可能です。

アプリケーションの場合、仮想パスには、IIS で定義されているとおりの、アプリケーションの名前が含まれます。サービスの場合、仮想パスにはアプリケーションの名前、スラッシュ、およびサービスの .svc ファイルまたは .xamlx ファイルの名前が含まれます。SiteName パラメーターと VirtualName パラメーターのセットを使用する場合は、Uri parameter.ps_virtualpath を使用しないでください。

エイリアス

なし

必須

false

位置

2

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

ワイルドカード文字の許可

-Confirm

コマンドの実行前に確認のプロンプトを表示します。

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

ワイルドカード文字の許可

false

-WhatIf

コマンドを実際に実行せずに、コマンドを実行した場合の結果を示します。

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

ワイルドカード文字の許可

false

<CommonParameters>

このコマンドレットは、-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable という一般的なパラメーターをサポートしています。詳細については、次を参照してください。 about_CommonParameters

入力

入力の型は、コマンドレットにパイプ処理できるオブジェクトの型です。

  • ApplicationInfo と ServiceInfo

例 1

このコマンドは、インスタンスのアンロード ポリシーをルート レベルで設定します。この例では、TimeToUnload パラメーターと TimeToPersist パラメーターの値が指定されています。希望であれば、これらのパラメーターのいずれか 1 つだけを指定することもできます。

Set-ASInstanceUnloadPolicy -Root -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”

例 2

このコマンドは、インスタンス アンロード ポリシーを Web サイト レベルで設定します。

Set-ASInstanceUnloadPolicy –SiteName “Default Web Site” -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”

例 3

これらのコマンドは、インスタンス アンロード ポリシーをアプリケーション レベルで設定します。

Set-ASInstanceUnloadPolicy –SiteName “Default Web Site” VirtualPath “/SampleService” -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”
Get-ASApplication –SiteName “Default Web Site” –VirtualPath “/SampleService” | Set-ASInstanceUnloadPolicy -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”

例 4

これらのコマンドは、インスタンス アンロード ポリシーをサービス レベルで設定します。

Set-ASInstanceUnloadPolicy –SiteName “Default Web Site” –VirtualPath “/SampleService/SampleService.xamlx” -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”
Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/SampleService/SampleService.xamlx” | Set-ASInstanceUnloadPolicy -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”

例 5

これらのコマンドは、Uri パラメーターの値によって決定されるレベルでインスタンス アンロード ポリシーを設定します。

Set-ASInstanceUnloadPolicy –Uri http://localhost -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”
Set-ASInstanceUnloadPolicy –Uri http://localhost/sampleservice/ -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”
Set-ASInstanceUnloadPolicy –Uri http://localhost/sampleservice/sampleservice.xamlx -TimeToUnload "00:00:40" –TimeToPersist “00:00:20”

例 6

このコマンドは、インスタンス アンロード ポリシー設定を上位のスコープから継承するようにサービスを構成します。

Set-ASInstanceUnloadPolicy –SiteName “Default Web Site” –VirtualPath “/SampleService/SampleService.xamlx” -UseInherited