Set-SPUsageApplication

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

利用状況アプリケーションのプロパティを設定します。

構文

Set-SPUsageApplication
   [-Identity] <SPUsageApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseName <String>]
   [-DatabasePassword <SecureString>]
   [-DatabaseServer <String>]
   [-DatabaseUsername <String>]
   [-EnableLogging]
   [-FailoverDatabaseServer <String>]
   [-UsageService <SPUsageServicePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

説明

コマンドレットは Set-SPUsageApplication 、使用状況アプリケーションのプロパティを設定します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

------------------- 例 ----------------------

Set-SPUsageApplication -Identity "Usage and Health data collection" -DatabaseServer "Server Name" -DatabaseName "New Logging DB"

この例では、ログデータを格納するために利用状況ログサービスで使用されるデータベースサーバーとデータベース名を変更します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバルストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

コマンドを実行する前に確認メッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseName

ログデータベースの名前を指定します。

この型は、SQL Server データベースの有効な名前 (UsageLogDB1 など) であることが必要です。

ログデータベースが存在しない場合は、自動的に作成されます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabasePassword

DatabaseUserName で指定したユーザーのパスワードを指定します。このパラメーターは、SQL Server 認証を使用してログデータベースにアクセスする場合のみ使用します。

この型は有効なパスワードであることが必要です。

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseServer

DatabaseName で指定したデータベースのホストサーバーの名前を指定します。

この型は、有効な SQL Server ホスト名 (SQLServerHost1 など) であることが必要です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseUsername

ログデータベースへの接続に使用するユーザー名を指定します。ログデータベースへのアクセスに SQL Server 認証を使用する場合にのみ、このパラメーターを使用します。

この型は、有効なユーザー名 (UserName1 など) であることが必要です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EnableLogging

この利用状況アプリケーションで利用状況データを収集するように指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-FailoverDatabaseServer

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

更新する利用状況アプリケーションを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、利用状況アプリケーションの有効な名前 (UsageApp1 など) であるか、有効な SPServiceApplication オブジェクトインスタンスであることが必要です。

Type:	SPUsageApplicationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UsageService

利用状況アプリケーションの親である SPUsageService オブジェクトを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、Usage サービスの有効な名前 (UsageService1 など) であるか、有効な SPUsageService オブジェクトインスタンスであることが必要です。

Type:	SPUsageServicePipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition