Start-ASApplication

Start-ASApplication

アプリケーションがメッセージを受け取り、自動的に開始できるようにします (アプリケーションの自動開始が有効の場合)。Start-ASApplication は、"previouslyEnabledProtocols" の内容を "enabledProtocols" にコピーしてから "previouslyEnabledProtocols" 属性を削除することにより、applicationHost.config ファイルのアプリケーション プロトコルを再有効化します。"previouslyEnabledProtocols" 属性が空であり、"enabledProtocols" が空でない場合、このコマンドレットはログ メッセージを発行します。applicationHost.config ファイル内のアプリケーションの “serviceAutoStartMode" 属性が “All” または “Custom” に設定されている場合、Start-ASApplication は、applicationHost.config ファイル内の "serviceAutoStartEnabled" 属性を "True" に設定します。

構文

Parameter Set: SiteNameAndVirtualPath
Start-ASApplication [-SiteName] <String> [[-VirtualPath] <String> ] [-StartApplicationPool] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ApplicationObject
Start-ASApplication -ApplicationObject <ApplicationInfo> [-StartApplicationPool] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Uri
Start-ASApplication [-Uri] <Uri> [-StartApplicationPool] [-Confirm] [-WhatIf] [ <CommonParameters>]

パラメーター

-ApplicationObject<ApplicationInfo>

開始するアプリケーションを指定します。

エイリアス

なし

必須

true

位置

named

既定値

なし

パイプライン入力の許可

true (ByValue)

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

-SiteName<String>

Web サイトの名前を、IIS マネージャーの [接続] ウィンドウで定義されているとおりに指定します。これにより、そのサイト内の 1 つ以上のアプリケーションを開始することを指定します。SiteName パラメーターには、Web サイト内の開始する特定のアプリケーションを指定する VirtualPath パラメーターを追加できます。Virtual Path を SiteName に追加しない場合、サイト内のすべてのアプリケーションが開始されます。SiteName パラメーターを使用する場合は、Uri パラメーターを使用しないでください。

エイリアス

なし

必須

true

位置

1

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

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

-StartApplicationPool

このフラグが指定されているときは、アプリケーション プールが実行中でない場合にコマンドレットによってアプリケーション プールが開始されます。この動作を可能にするには、アプリケーションの appPool の startMode が "AlwaysRunning" に設定されている必要があります。詳細については、T:Microsoft.ApplicationServer.Management.Commands.Set-ASApplication を参照してください。

エイリアス

なし

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

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

-Uri<Uri>

サイトまたはアプリケーションの URI。開始する 1 つ以上のアプリケーションを指定します。この URI がサイトの URI である場合、そのサイト内のすべてのアプリケーションが開始されます。この URI がアプリケーションの URI である場合、そのアプリケーションのみが開始されます。Uri パラメーターを使用する場合は、SiteName パラメーターと VirtualPath パラメーターのセットを使用しないでください。

エイリアス

なし

必須

true

位置

1

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

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

-VirtualPath<String>

アプリケーションの仮想パスを、IIS マネージャーの [接続] ウィンドウで定義されているとおりに指定します。これにより、開始するアプリケーションを指定します。VirtualPath パラメーターを SiteName パラメーターに追加し、SiteName を使用してアプリケーションが含まれるサイトを示す必要があります。仮想パスの先頭の "/" 文字は省略可能です。仮想パスには、IIS で定義されているとおりの、アプリケーションの名前が含まれます。SiteName パラメーターと VirtualName パラメーターのセットを使用する場合は、Uri パラメーターを使用しないでください。

エイリアス

なし

必須

false

位置

2

既定値

なし

パイプライン入力の許可

true (ByPropertyName)

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

-Confirm

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

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

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

false

-WhatIf

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

必須

false

位置

named

既定値

なし

パイプライン入力の許可

false

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

false

<CommonParameters>

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

入力

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

  • なし

出力

出力の型は、コマンドレットから生成されるオブジェクトの型です。

  • なし

例 1

既定の Web サイト内の myApp アプリケーションを開始します。

Start-ASApplication -SiteName “Default Web Site” -VirtualPath “/myApp”

例 2

既定の Web サイト内のすべてのアプリケーションを開始します。

Start-ASApplication -SiteName “Default Web Site”