PowerShell を介してプログラムインターフェイスを呼び出すことにより、Fly 機能にアクセスして利用することができます。以下のセクションでは、すべての前提条件と例についてガイダンスを提供します。詳細については、https://github.com/AvePoint/FLY-Migration/tree/master/WebAPI (英語) のサンプルを参照してください。
Fly を旧バージョンからアップグレードした場合、PowerShell のサンプルコード内の特定のスクリプト、コマンドレット、パラメーターが新機能に対応するために更新された場合があります。更新の詳細については、Fly PowerShell アップデート リスト (英語) を参照してください。
PowerShell で Fly を使用するには、Windows PowerShell のバージョンが5.1以上であることを確認してください。
1. Fly マネージャー サーバー上の ...\APElements\FLY\Manager\powerShell ディレクトリにある Import-FLYMigration.ps1 ファイルを実行して、PowerShell モジュールをインポートします。
2. ...\APElements\FLY\Manager\PowerShell ディレクトリにある UpdateCertificatePolicy.ps1 ファイルを実行して、証明書ポリシーを更新します。
3. Fly > 管理 > 全般設定 > API キー に移動して、API キーを生成してコピーします。
4. 各移行タイプのサンプルは、...\APElements\FLY\Manager\PowerShell\SampleCodes\FLY ディレクトリで検索できます。
以下のセクションでは、PowerShell を使用して移行プランを作成し、移行ジョブを実行する方法を示すために、Exchange メールボックスの移行を例として説明します。
移行プランの作成方法については、以下の説明を参照してください。
1. ...\APElements\FLY\Manager\PowerShell\SampleCodes\FLY\Exchange\PlanCSVs ディレクトリにある ImportPlanTemplate.csv テンプレート ファイルを使用して、移行プランを一括で設定することができます。このファイルで、以下のカラムの値を構成することで、各行のプラン情報を定義することができます。
•Source Connection/Destination Connection – 移行元または移行先接続の名前または ID を入力します。
•Source Type/Destination Type - Online または OnPremise 入力して、移行元または移行先接続タイプを定義します。
•Mapping Csv – 作成する移行プランの名前を入力します。同一移行元と移行先のプランを複数作成する場合は、複数の名前を入力してカンマで区切ります。この名前は、ステップ 2 で構成された移行マッピングを含む CSV ファイルの名前と一致している必要があることに注意してください。
2. ...\APElements\FLY\Manager\PowerShell\SampleCodes\FLY\Exchange\PlanCSVs ディレクトリ内の ExchangeImportPlan_Number.csv テンプレート ファイルを使用して、移行マッピングを一括で構成します。各ファイルでは、1 件のプランで移行マッピングを構成し、ファイル名が作成するプラン名と一致していることを確認します。このファイルで、以下のカラム値を構成することで、各行に 1 件の移行マッピングを定義することができます。
•Source Email Address/Destination Email Address – 移行元メールボックスまたは移行先メールボックスのメール アドレスを入力します。
•Source Type/Destination Type – 移行元と移行先のメールボックス タイプを定義するには、UserMailbox、ArchiveMailbox、SharedMailbox、ResourceMailbox、または Microsoft365GroupMailbox を入力します。
•Migrate Archive Mailbox – 移行元メールボックスのアーカイブ メールボックスを移行するかどうかを定義するために、True または False を入力します。
•Migrate Deletions Folder – 移行元メールボックスの削除フォルダーを移行するかどうかを定義するために、True または False を入力します。
•Convert to Shared Mailbox – メールボックスを共有メールボックスに変換するかどうかを定義するには、True または False を入力します。
3. テンプレートを構成した後、...\APElements\FLY\Manager\PowerShell\SampleCodes\FLY\Exchange ディレクトリ内の Batches-CreatePlansOfExchange.ps1 ファイルを編集して移行設定を構成します。
a. API キーと BaseUri を対応するパラメーターに入力します。
BaseUri は、Fly マネージャーへのログインに使用する URL です。例: https://10.1.1.11:20100
b. 移行ポリシー、移行データベース、プラン グループ、および移行プランのスケジュール設定を構成します。
c. 対応するパラメーターを追加することで、移行プランの以下の詳細設定を有効にすることができます。
$PlanSettings = New-ExchangePlanSettingsObject -DisplayName $PlanNameLabel -PolicyId $Policy -DatabaseId $Database -PlanGroups $PlanGroups -Schedule $Schedule -MigrateMailboxRules -MigrateMailboxPermissions -SynchronizeDeletion -MigrateAutoCompleteList -MigrateContacts
o -MigrateMailboxRules – メールボックス ルールを移行します。
o -MigrateMailboxPermissions – メールボックス権限を移行します。
o -SynchronizeDeletion – 削除機能の同期を有効にします。
o -MigrateAutoCompleteList – 自動完了リストを移行します。
o -MigrateContact – グローバル連絡先を移行します。
4. Batches-CreatePlansOfExchange.ps1 ファイルを実行します。構成した移行プランが作成されます。
移行ジョブを実行するには、以下の説明を参照してください。
1. 移行プラン作成した際に、...\APElements\FLY\Manager\PowerShell\SampleCodes\FLY\Exchange ディレクトリ内の Start-ExchangeJobByPlan.ps1 ファイルを編集して移行設定を構成します。
a. API キーおよび BaseUri を対応するパラメーターに入力します。
BaseUri は、Fly マネージャーへのログインに使用する URL です。例: https://10.1.1.11:20100
b. 実行する移行プランの ID / 名前を $PlanId = ' ' パラメーター値として構成します。
c. Online/OnPremises を $PlanType = ' ' パラメーター値として構成し、移行プランのタイプを定義します。
d. 移行プランのジョブ設定を構成します。
o 完全 / 増分 / 失敗したオブジェクトジョブを実行するには、移行タイプを $Settings = New-ExchangePlanExecutionObject の -MigrationType パラメーター値として構成します。
§ Full - 完全ジョブを実行します。
§ Incremental – 増分ジョブを実行します。
§ FailedObjectsOnly – 失敗したオブジェクトのジョブのみを実行します。
o 事後移行ジョブを実行するには、以下のパラメーターを構成して、事後移行の設定を実行します。
事後移行ジョブは、メールボックス移行にのみ使用できます。
$PostMigration = New-PostMigrationOptionsObject -SharedCalendarPermission:$true -EnableForward:$true -ForwardAndCopy:$true -DisableForwarding:$false -DnsToSMTP:$false
$Settings = New-ExchangePlanExecutionObject -MigrationType PostMigration -PostMigrationOptions $PostMigration
§ -SharedCalendarPermission – 共有カレンダー権限を移行するには、$true を入力します。それ以外の場合は、$false を入力します。
§ -EnableForward – $true を入力して、メール転送を構成します。それ以外の場合は、$false を入力します。
§ -ForwardAndCopy – $true を入力して、メール転送を有効にし、転送されたメールのコピーを移行元メールボックスに保持します。それ以外の場合は、$false を入力します。この設定は、-EnableForward パラメーターの値が $true の場合にのみ機能することに注意してください。
§ -DisableForwarding – $true を入力して、メール転送を無効にします。それ以外の場合は、$false を入力します。
§ -DnsToSMTP – $true を入力して、X500 メール アドレスを移行先メールボックスに追加します。それ以外の場合は、$false を入力します。
2. Start-ExchangeJobByPlan.ps1 ファイルを実行します。移行ジョブが開始されます。