バックアップと復元のための自動構成ツールコマンドレット

このページには、Web Studio が使用するバックアップおよび復元 API をトリガーするためにツールがサポートするすべてのコマンドレットとパラメーターがリストされています。

バックアップストレージコマンドレット

Get-BckRstrStorage

このコマンドレットはオンプレミスのみに適用されます。バックアップが保存されるストレージの詳細を取得します。

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、「XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud」を参照してください。
Environment 本番環境の種類: プロダクション, プロダクションGov, プロダクションJP, オンプレミス.
Quiet コンソールへの出力を抑制するためのパラメーター。

セット-バックリストアストレージ

このコマンドレットはオンプレミスのみに適用されます。バックアップが保存される新しいストレージを設定します。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ: プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
MaximumBackups 新しいバックアップが作成されたときに、バックアップクリーンアッププロセスが最も古いバックアップを削除するまで保持される、ピン留めされていないバックアップの最大数。
MaximumPinnedBackups 保持されるピン留めされたバックアップの最大数。これらのバックアップはクリーンアッププロセスによって削除されません。
BlobStorageType ストレージの種類: FileStorage または CustomerAzureStorage
FileStoragefolder BlobStorageType FileStorage オプションの完全修飾フォルダー指定。
Info1
FileStorage の場合、オプションの UserName
CustomerAzureStorage の場合、Azure SAS のアドレス
Info2 FileStorage の場合、オプションのパスワード
Info3Info4 使用されていません

Test-BckRstrStorage

このコマンドレットはオンプレミスのみに適用されます。定義されたストレージが有効であることを確認するためにテストします。

FileStorage の場合、テストはフォルダーが存在し、書き込み可能であることを確認します。

CustomerAzureStorageの場合、テストはSAS URLが正しい権限を持っていること、および現在の日付がURLの開始日と終了日の範囲内であることを確認します。

有効な場合はtrueを返し、無効な場合はfalseを返します。

パラメーター:

パラメーター 項目説明
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ: プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するパラメーター。

バックアップコマンドレット

Get-BckRstrBackups

バックアップまたは復元BLOBストレージの場所に保存されているバックアップを列挙します。Citrix Virtual Apps and Desktops™の場合、この場所は管理者がWebStudioを通じて設定します。DaaSの場合、これは既存の顧客Azureストレージです。各バックアップに関する完全な情報については、Get-BckRstrBackupsWithDetiailsを使用してください。バックアップの詳細は次のとおりです。

  • バックアップ名
  • メモ
  • ピン留め済み (true または false)
  • バックアップの日時
  • 履歴UID
  • 関連UID (最後の復元履歴レコードのUID)
  • 関連する日付と時刻
  • チェックモードで実行された場合に関連
  • 期間(秒)
  • 管理者の名前
  • 各コンポーネントを列挙した詳細と、各コンポーネント内のメンバー数。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーターです。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud を参照してください。
Environment 本番環境のタイプ:本番、本番Gov、本番JP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。

ゲット-バックリストアバックアップメンバーズ

選択したバックアップに保存されている単一コンポーネントのメンバーを列挙します。メンバー名は単純なリストで返されます。

コンポーネントは次のとおりです。

  • タグ
  • 管理スコープ
  • 管理ロール
  • 管理者(オンプレミスのみ)
  • ホスト接続
  • アイコン
  • 管理フォルダー
  • マシンカタログ
  • ストアフロント
  • デリバリーグループ
  • アプリケーショングループ
  • アプリケーションフォルダー
  • アプリケーション
  • App-V ホストサーバー
  • アプリケーションライブラリパッケージ検出
  • App-V分離グループ
  • グループポリシー
  • ユーザーゾーン設定
  • サイトデータ
  • ゾーン(オンプレミスのみ)

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud を参照してください。
Environment The type of production environment: Production, ProductionGov, ProductionJP, OnPrem.
Quiet コンソールへの出力を抑制するためのパラメーター。
BackupName バックアップの名前。.zip拡張子はオプションです。
Component バックアップに含めるコンポーネント。

New-BckRstrBackup

Delivery Controllerで新しいバックアップアクションを開始します。このアクションは、New-BckRstrBackupコマンドレットに対して非同期です。

パラメータ:

パラメータ Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
Notes バックアップに関するメモ。
PollForCompletion アクションが完了するまで、Delivery Controllerで実行中のアクションをポーリングするためのパラメーター。Quiteパラメーターが指定されていない限り、ポーリングは進行状況と完了結果をコンソールにログ記録します。

バックアップをピン留めするコマンドレット

Set-BckRstrPinBackups

Delivery Controllerのバックアップクリーンアッププロセスの一部として削除されないように、バックアップをピン留めします。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
BackupName バックアップの名前。.zip 拡張子はオプションです。

Set-BckRstrUnpinBackups

バックアップのピン留めを解除し、Delivery Controller のバックアップクリーンアッププロセスで削除できるようにします。

パラメーター:

パラメーター 項目説明
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される、既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ: プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
BackupName バックアップの名前。.zip拡張子はオプションです。

バックアップの削除コマンドレット

Remove-BckRstrBackup

1つ以上のバックアップを削除します。

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
IncludeByName 復元対象とするコンポーネントメンバーを指定するためのフィルター。これは、コンマ区切りのフィルター値のリストであり、ワイルドカード文字 * および ? を含めることができます。

スケジュールされたバックアップコマンドレット

ゲット-バックリストアスケジュールズ

バックアップスケジュールのリストを取得します。

パラメーター:

パラメーター 説明書き
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーターです。セキュリティプロファイルの設定方法については、「XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloud」を参照してください。
Environment 本番環境のタイプ:本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するパラメーター。
BackupName バックアップの名前。.zip 拡張子はオプションです。
Notes 設定または変更するメモ。

New-BckRstrSchedule

新しいバックアップスケジュールを作成します。

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
Name スケジュール名。
Frequency 頻度の種類: 日次、週次、または月次。
Day 頻度が日次の場合。
DaysInWeek 頻度が週次の場合。
DayInMonth 頻度が月次の場合。
WeekInMonth 頻度が月次の場合。
StartDate 形式は M/d/yy です。
StartTime 24時間形式で指定された開始時刻。
FrequencyFactor 毎日 (値 = 1) または隔日 (値 = 2) のように、n 回ごとに実行します。
Description スケジュールされたバックアップの説明
Enabled このバックアップスケジュールを有効にするパラメーター。有効な場合は True、無効な場合は false
TimeZoneId Windows タイムゾーンの識別子

Set-BckRstrSchedule

既存のバックアップスケジュールを変更します。変更するスケジュールを選択するには、名前またはUidを指定します。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ:プロダクション、プロダクションガブ、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
Name スケジュール名。
Uid スケジュール名を変更する場合。
Frequency 頻度の種類: 毎日、毎週、または毎月。
Day 頻度が毎日の場合。
DaysInWeek 頻度が毎週の場合。
DayInMonth 頻度が毎月の場合。
WeekInMonth 頻度が毎月の場合。
StartDate 形式は M/d/yy です
StartTime 24時間形式で指定された開始時刻。
FrequencyFactor 毎日 (値 = 1) または隔日 (値 = 2) のように、n 回ごとに実行します。
Description スケジュールされたバックアップの説明。
Enabled このバックアップスケジュールを有効にするパラメーター。有効な場合は True、無効な場合は false
TimeZoneId Windows タイムゾーン識別子

セット-ビーシーケーアールエスティーアールスケジュールイネーブルド

既存のバックアップスケジュールを有効にします。有効にするスケジュールを選択するには、名前または Uid を指定します。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ:プロダクション、プロダクションガブ、プロダクションジェイピー、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
Name スケジュール名。
Uid スケジュール名を変更する場合。

Set-BckRstrScheduleDisabled

既存のバックアップスケジュールを無効にします。無効にするスケジュールを選択するには、名前またはUidを指定します。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類:プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
Name スケジュール名。
Uid スケジュール名を変更する場合。

バックアップを制限するコマンドレット

Set-BckRstrOptions

スケジュールされたバックアップを1日1回に制限し、同一のバックアップを回避します。

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
OneScheduledBackupPerDay 同一のバックアップを避けるため、スケジュールされたバックアップを1日1回に制限するパラメーター。

復元コマンドレット

BckRstrバックアップの復元

既存のバックアップから単一コンポーネントのメンバーを復元します。

パラメーター:

パラメーター Description
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される、既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ:プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
BackupName バックアップの名前。.zip拡張子はオプションです。
Component バックアップに含めるコンポーネント。
Notes バックアップに関するメモ。
CheckMode 復元されるコンポーネントメンバーを識別するためのパラメーターですが、実際の復元は実行しません。
RestoreType The restore type: MissingOnly or MissingUpdateExisting
IncludeByName 復元対象とするコンポーネントメンバーを指定するためのフィルター。これは、コンマ区切りのフィルター値のリストであり、ワイルドカード文字 * および ? を含めることができます。

履歴コマンドレット

ゲット-バックリストアヒストリー

すべてのアクションの履歴詳細リストを取得します。

パラメーター:

パラメーター 項目説明
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティ情報と環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境のタイプ: 本番、政府機関向け本番、日本向け本番、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。

ゲット-バックリストアスペシフィックバックアップヒストリー

特定のバックアップの履歴詳細のリストを取得します。

パラメーター:

パラメーター 項目説明
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: プロダクション、プロダクションGov、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメーター。
BackupName バックアップの名前。.zip拡張子はオプションです。

Set-BckRstrNotes

履歴レコードのメモを設定または変更します。

パラメーター:

パラメーター 説明文
CustomerId ベアラートークンを取得するために必要な顧客ID。
CientId ベアラートークンを取得するために必要なクライアントID。
Secret ベアラートークンを取得するために必要なシークレット。
CustomerInforFileSpec セキュリティおよび環境情報を含む顧客情報ファイルの完全修飾ファイル指定。
ProfileName 以前のパラメーターの代わりに使用される既存のセキュリティプロファイルを識別するためのパラメーター。セキュリティプロファイルの設定方法については、XenApp & XenDesktop: Remote PowerShell SDK v2 for Citrix Cloudを参照してください。
Environment 本番環境の種類: プロダクション、プロダクションガブ、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメータ。
BackupName バックアップの名前。.zip拡張子はオプションです。
Notes 設定または変更するメモ。
バックアップと復元のための自動構成ツールコマンドレット