Invoke-ProcessASDatabase

  • リファレンス
モジュール:
SQLServer

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

構文

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

説明

基になるメタデータの種類に応じて、特定の ProcessType または RefreshType を使用して、指定されたデータベースに対して 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。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CertificateThumbprint

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

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

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Database

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

型:Object
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DatabaseName

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProcessType

互換性レベル 1050 から 1103 の多次元データベースまたは表形式データベースのプロセスの種類を指定します。

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

型:ProcessType
指定可能な値:ProcessFull, ProcessAdd, ProcessUpdate, ProcessIndexes, ProcessData, ProcessDefault, ProcessClear, ProcessStructure, ProcessClearStructureOnly, ProcessScriptCache, ProcessRecalc, ProcessDefrag
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

型:ActionPreference
Aliases:proga
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RefreshType

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

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

型:RefreshType
指定可能な値:Full, ClearValues, Calculate, DataOnly, Automatic, Add, Defragment
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Server

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePrincipal

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TenantId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.Object

出力

System.Object

メモ

すべての Analysis Services インスタンスでサポートされます