Set-SPMachineKey
Web アプリケーションの ASP.NET ビュー ステート復号化キーと検証キーを構成します。
構文
Set-SPMachineKey
-WebApplication <SPWebApplicationPipeBind>
[-DecryptionKey <String>]
[-ValidationKey <String>]
[-Local]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
'Set-SPMachineKey' コマンドレットは、Web アプリケーションの ASP.NET ビューステート復号化キーと検証キーを構成します。
例
------------- 例 1 -------------
Set-SPMachineKey -WebApplication http://sitename次の使用例は、Web アプリケーション 'http://sitename' の ASP.NET ビューステート復号化キーと検証キーを、新しいランダムに生成されたキーに設定します。 新しいキーは、ファーム内のすべてのサーバーにデプロイされます。
------------- 例 2 -------------
Set-SPMachineKey -WebApplication http://sitename -DecryptionKey '<Your Key!>' -ValidationKey '<Your Key!>' -Local前のサンプルでは、Web アプリケーション 'http://sitename' の ASP.NET ビューステートの復号化キーと検証キーを、DecryptionKey パラメーターと ValidationKey パラメーターで指定された新しいキーに設定します。 新しいキーはローカル サーバーにのみデプロイされます。 ファーム内の他のサーバーでは、引き続き前のキーが使用されます。
キーの生成に関する情報については、「ビュー ステート メッセージ認証コード (MAC) エラーサポートの解決」の「<machineKey> elementを生成する方法」を参照してください。
パラメーター
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
| 型: | SPAssignmentCollection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-DecryptionKey
新しい ASP.NET ビュー ステート復号化キーを指定します。 キーは、64 文字の長い 16 進文字列 (0 から 9 および A から F) として表す必要があります。
このパラメーターを指定しない場合は、ランダムな暗号化解除キーが生成され、使用されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-Local
新しい復号化キーと検証キーをローカル サーバーにのみデプロイします。 ファーム内の他のサーバーでは、以前の復号化キーと検証キーが引き続き使用されます。 ファーム内の複数のサーバー間で負荷分散された Web セッションは、ファーム内のすべてのサーバーでこれらのキーが同期されていない場合、失敗します。 Update-SPMachineKey コマンドレットを使用して、ファーム内の追加のサーバーにキーをデプロイします。
このパラメーターを指定しない場合、新しい復号化キーと検証キーがファーム内のすべてのサーバーにデプロイされます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-ValidationKey
新しい ASP.NET ビューステート検証キーを指定します。 キーは、64 文字の長い 16 進文字列 (0 から 9 および A から F) として表す必要があります。
このパラメーターを指定しない場合は、ランダムな暗号化解除キーが生成され、使用されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-WebApplication
Web アプリケーションの名前、URL、または GUID を指定します。
| 型: | SPWebApplicationPipeBind |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | SharePoint Server Subscription Edition |