Invoke-ProcessASDatabase

リファレンス

モジュール:: SQLServer

基になるメタデータの種類に応じて、特定の ProcessType または RefreshType の指定した Database に対して Process 操作を実行します。

構文

Invoke-ProcessASDatabase
      [-DatabaseName] <String>
      [-RefreshType] <RefreshType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessASDatabase
      [-DatabaseName] <String>
      [-ProcessType] <ProcessType>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessASDatabase
      [-RefreshType] <RefreshType>
      -Database <Object>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-ProcessASDatabase
      [-ProcessType] <ProcessType>
      -Database <Object>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

基になるメタデータの種類に応じて、特定の ProcessType または RefreshType の指定した Database に対して Process 操作を実行します。

多次元メタデータを持つデータベースには ProcessType を使用します (これには、互換性レベルが 1200 未満の表形式データベースが含まれます)。互換性レベル 1200 以上の表形式データベースには RefreshType を使用します。

Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.

例

名前を使用して AS テーブルデータベース全体を処理する

PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\DB1\> Invoke-ProcessASDatabase -DatabaseName "DB1"  -RefreshType "Full"

パイプラインを使用して AS テーブルデータベース全体を処理する

PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\> $db = (gci "DB1")
PS SQLSERVER:\SQLAS\MachineName\Instance\Databases\> $db | Invoke-ProcessASDatabase -RefreshType "Full"

パラメーター

-ApplicationId

サービスプリンシパルのアプリケーション ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

サービスプリンシパルの証明書の拇印。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

このパラメーターを指定した場合は、指定された Analysis Server インスタンスへの接続に、渡されたユーザー名とパスワードが使用されます。

資格情報を指定していない場合は、ツールを実行しているユーザーの既定の Windows アカウントが使用されます。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

処理対象の表形式または多次元データベースを指定します。

Type:	Object
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DatabaseName

処理する表形式データベースまたは多次元データベースの名前を指定します。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ProcessType

互換性レベル 1050 ～ 1103 の多次元データベースまたは表形式データベースの場合、処理の種類を指定します。

説明とガイダンスについては、処理オプションと設定 (Analysis Services) を参照してください。

Type:	ProcessType
Accepted values:	ProcessFull, ProcessAdd, ProcessUpdate, ProcessIndexes, ProcessData, ProcessDefault, ProcessClear, ProcessStructure, ProcessClearStructureOnly, ProcessScriptCache, ProcessRecalc, ProcessDefrag
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RefreshType

表形式データベースのプロセスの種類を指定します。

説明とガイダンスについては、データベース、テーブル、またはパーティションの処理 (Analysis Services) に関するページを参照してください。

Type:	RefreshType
Accepted values:	Full, ClearValues, Calculate, DataOnly, Automatic, Add, Defragment
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

必要に応じて、SQLAS プロバイダーディレクトリに存在しない場合に接続するサーバーインスタンスを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

この接続がサービスプリンシパルを使用していることを指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

サービスプリンシパルのテナント ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

System.Object

出力