Backup-ASDatabase

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

データベース管理者が Analysis Service Database のバックアップをファイルに取得できるようにします。

構文

Backup-ASDatabase
      [-BackupFile] <String>
      [-Name] <String>
      [-AllowOverwrite]
      [-BackupRemotePartitions]
      [-ApplyCompression]
      [-FilePassword <SecureString>]
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-ASDatabase
      [-AllowOverwrite]
      [-BackupRemotePartitions]
      [-ApplyCompression]
      [-FilePassword <SecureString>]
      -Database <Database[]>
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-ASDatabase
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-ASDatabase
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-ASDatabase
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

データベース管理者が Analysis Service Database のバックアップをファイルに取得できるようにします。 場所なしでバックアップ ファイル名のみを指定した場合は、インストール時に指定された既定のバックアップ場所が考慮されます。 データベース管理者は、パイプラインを介して複数のデータベースを渡し、バックアップ操作を実行することもできます。

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

例

例 1: 名前によるデータベースのバックアップ

Backup-ASDatabase mydb.abf mydatabase

例 2: 圧縮を使用したデータベースのバックアップ

Backup-ASDatabase "D:\MyFolder\mydb.abf" mydatabase -AllowCompression

例 3: 圧縮と暗号化を使用してデータベースをバックアップする

Backup-ASDatabase "D:\MyFolder\mydb.abf" mydatabase -AllowCompression -FilePassword:$pwd

パラメーター

-AllowOverwrite

バックアップ中に転送先ファイルを上書きできるかどうかを示します。

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

-ApplicationId

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

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

-ApplyCompression

バックアップ ファイルを圧縮するかどうかを示します。

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

-BackupFile

データベースがバックアップされるバックアップ ファイルのパス/名前。 場所なしでバックアップ ファイル名のみを指定した場合は、インストール時に指定された既定のバックアップ場所が考慮されます。 このパラメーターは、バックアップするデータベースが Name パラメーターで指定されている場合にのみ使用され、Database パラメーターで渡される場合は使用されません。

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

-BackupRemotePartitions

リモート パーティションをバックアップするかどうかを示します。

型:SwitchParameter
配置: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

バックアップするデータベース。 バックアップのファイル名はデータベースと同じになります。

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

-FilePassword

バックアップ ファイルの暗号化に使用するパスワード

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

-Name

バックアップする必要がある Analysis Services データベース名。

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

-ProgressAction

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

型:ActionPreference
Aliases:proga
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る: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

入力

Microsoft.AnalysisServices.Database[]

出力

System.Object

メモ

現在、PowerBI Premium 製品ではサポートされていないすべての Analysis Services インスタンスでサポートされています。 今後サポートされる予定です。