ActiveReports 11.0J Serverでは、レポート、ユーザー、ロールなどのリソースを1つのサーバーから別のサーバーに移行するためのPowerShellモジュールの移行ツールが用意されています。本ツールは移行の用途だけでなく、各リソース類のバックアップや復元の用途にも使用できます。

リソース移行ツールは以下の場所に配置してあります。

C:\ActiveReports 11.0J Server\SDK\Samples\Migration PowerShell Module

サンプルの実行

Windows PowerShellコンソールを開きます。
次のコマンドを入力します。
cd "%\Samples\Migration PowerShell Module"

PowerShellコンソールでは、次のコマンドを実行してモジュールを使用します。

PS C:\> Set-ExecutionPolicy Unrestricted -Scope CurrentUser
PS C:\> Import-Module .\ArsMigration.psd1

メモ： 上記のコマンドを実行すると、次の警告メッセージが表示されます。

警告：モジュール 'ArsMigration'からインポートされたコマンドの中には、名前に承認されていない動詞を含むものがあり、このようなコマンドは検出される可能性が低くなる場合があります。承認されていない動詞を含むコマンドを見つけるには、Verbose パラメーターを使用してもう一度Import-Module コマンドを実行してください。承認されている動詞の一覧を表示するには、「Get-Verb」と入力してください。

警告メッセージを無効にするには、次のコマンドを実行します。

PS C:\> Import-Module .\ArsMigration.psd1 -disablenamechecking

使用可能なコマンドのリストの取得

次のコマンドを実行して、使用可能なコマンドのリストを実行します。

PS C:\> Get-Command -Module ArsMigration

使用可能なコマンド

Export-ArsData

ActiveReports Serverからデータをエクスポートします。

構文

Export-ArsData [[-Types] <String[]>] [-Path] <String> [[-Session] <PSObject>] [<CommonParameters>]

パラメーター

-Types <String[]>：エクスポートするリソースのタイプです。指定されていない場合、すべてのサポートされているリソースがエクスポートされます。

メモ：すべてのロールをエクスポートするには、Typesパラメーターでロールを「'$roles'」のように指定する必要があります。

-Path <String>：エクスポートされたアーカイブを格納する出力ファイルです。

-Session <PSObject>：ターゲットのサーバーのセッションオブジェクトです。

<CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、
「about_CommonParameters」を参照してください。

必須なパラメーター

Path

例

Export-ArsData -Types reports,themes -Path data.zip
Export-ArsData -Path data.zip
Export-ArsData -Types reports,themes -Path data.zip -Session @{uri='http://another-ars-instance'; token='123...'}
Export-ArsData -Types '$roles' -Path data_roles.zip

Get-ArsList

ActiveReports Server から指定されたタイプのリソースリストを取得します。

構文	Get-ArsList [-Type] <String> [[-Session] <PSObject>] [<CommonParameters>]
パラメーター	-Type <String>：リストするリソースのタイプです。 -Session <PSObject>：ターゲットのサーバーのセッションオブジェクトです。 <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	Type
例	Get-ArsList -Type Report Get-ArsList -Type Report -Session @{uri='http://another-ars-instance'; token='123...'}

Get-ArsResource

指定されたリソースの内容を取得します。

構文	Get-ArsResource [-Id] <String> [-Type] <String> [[-Path] <String>] [-Description] [[-Session] <PSObject>] [<CommonParameters>]
パラメーター	-Id <String>：リソースの id です。 -Type <String>：リソースのタイプです。 -Path <String>：出力ファイルへのパスです。 -Description [<SwitchParameter>]: -Session <PSObject>：データの移行先のサーバーを指定するセッションオブジェクトです。 <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	Id Type
例	Get-ArsResource -id 224234d34234 -Type report Get-ArsResource -id 224234d34234 -Type report -Path data.rdlx Get-ArsResource -id 224234d34234 -Type report -Path data.rdlx -Description:$true

Import-ArsData

以前にエクスポートしたデータを指定されたファイルからターゲットの ActiveReports Server にインポートします。

構文	Import-ArsData [-Path] <String> [[-Session] <PSObject>] [<CommonParameters>]
パラメーター	-Path <String>：エクスポートされたアーカイブへのパスです。 -Session <PSObject>：データの移行先のサーバーを指定するセッションオブジェクトです。 <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	Path
例	Import-ArsData -Path data.zip Import-ArsData -Path data.zip -Session @{uri='http://another-ars-instance'; token='123...'}

Migrate-ArsResource

サーバーから別のサーバーまでの単一リソースの移行を実行します。

構文	Migrate-ArsResource [-Type] <String> [-Id] <String> [[-From] <PSObject>] [[-To] <PSObject>] [-SkipValidation] [<CommonParameters>]
パラメーター	-Type <String>：移行されたリソースのタイプです。 -Id <String>：移行されたリソースの id です。 -From <PSObject>：データの移行元のサーバーを指定するセッションオブジェクトです。 -To <PSObject>：データの移行先のサーバーを指定するセッションオブジェクトです。 -SkipValidation [<SwitchParameter>] <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	Id Type
例	Migrate-ARsResource -type report -id 582069eb5302 $prodServer=New-ArsSession -User admin -Password 2 -uri http://another-ars-instance/ Migrate-ArsResource -Type report -Id 5809a9249497eb1298b4486b -To $prodServer Migrate-ARsResource -type report -id 582069eb53020c3da8930f0a -To (new-arssession -user admin -password admin -uri http://another-ars-instance) Migrate-ARsResource -type report -id 582069eb53020c3da8930f0a -from (new-arssession -user admin -password admin -uri http://another-ars-instance) -TO (new-arssession -user admin -password admin -uri http://another-ars-instance)

Migrate-ArsResources

サーバーから別のサーバーまですべてのリソースの移行を実行します。

構文

Migrate-ArsResources [[-Type] <String[]>] [[-From] <PSObject>] [[-To] <PSObject>] [<CommonParameters>]

パラメーター

-Type <String[]>：移行されたリソースのタイプです。

メモ：すべてのロールを移行するには、Typesパラメーターでロールを「'$roles'」のように指定する必要があります。

-From <PSObject>：データの移行元のサーバーを指定するセッションオブジェクトです。

-To <PSObject>：データの移行先のサーバーを指定するセッションオブジェクトです。

<CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。

必須なパラメーター

Null

例

$from = New-ArsSession -User admin -Password 1 -uri http://localhost:8080/
$to = New-ArsSession -User admin -Password 2 -uri http://another-ars-instance/
Migrate-ArsResources -Type reports -From $from -To $to
Migrate-ArsResources -Type users,'$roles' -To (New-ArsSession -User admin -Password 2 -uri http://another-ars-instance/)
Migrate-ArsResources
Migrate-ArsResources -To (New-ArsSession -User admin -Password 2 -uri http://another-ars-instance/)

New-ArsResource

リソースを ActiveReports Server にアップロードします。

構文	New-ArsResource [-Name <String>] -Type <String> -Path <String[]> [-Overwrite] [-SkipValidation] [-Session<PSObject>] [<CommonParameters>] New-ArsResource [-Name <String>] -Type <String> -Content <Array> [-Overwrite] [-SkipValidation] [-Session<PSObject>] [<CommonParameters>]
パラメーター	-Name <String>：新規リソースの名前です。 -Type <String>：新規リソースのタイプです。 -Path <String[]>：アップロードするファイルへのパスです。 -Content <Array>：文字列としてのリソースの内容です。 -Overwrite [<SwitchParameter>]：既存のリソースを同じ名前で上書きするかどうかを指定します。 -SkipValidation [<SwitchParameter>] -Session <PSObject>：データの移行先のサーバーを指定するセッションオブジェクトです。 <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	Type Path Content
例	New-ArsResource -Type report -Name Invoice -Path invoice.rdlx New-ArsResource -Type report -Name Invoice -Path invoice.rdlx - Overwrite:$true New-ArsResource -Type report -Name Invoice -Path invoice.rdlx - Overwrite:$true -Session @{uri='http://another-ars-instance'; token='123...'} New-arsresource -name mymigratereporty -type report -content "<Content>"

New-ArsSession

指定されたユーザーの資格情報と ActiveReports Server URI を使用してセッションを作成します。

構文	New-ArsSession [-User] <String> [-Password] <String> [[-Uri] <String>] [-Default] [<CommonParameters>]
パラメーター	-User <String>：ログインするユーザー名です。 -Password <String>：指定されたユーザーのパスワードです。 -Uri <String>：サーバーの URI です。 -Default [<SwitchParameter>]：結果を他のコマンドレットのデフォルトセッションとして設定するかどうかを指定します。 <CommonParameters>：このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および OutVariable。詳細については、「about_CommonParameters」を参照してください。
必須なパラメーター	User Password
例	New-ArsSession -user admin -password admin New-ArsSession -user admin -password admin -uri http://another-ars-instance New-ArsSession -user admin -password admin -uri http://another-ars-instance/ -default:$true

各コマンドの詳細情報の取得

各コマンドの詳細情報を取得するには、次のコマンドを実行します。

PS C:> Get-Help <Command> -Full

モジュールの自動ロードの有効化

現在のユーザーに対してモジュールをインストールして、モジュールの自動ロードを有効にするには、モジュールファイルを次の場所に配置します。

$Home\Documents\WindowsPowerShell\Modules\ArsMigration