Citrix Virtual Apps and Desktops

バックアップと復元のための自動構成ツールcmdlet

このページでは、Web Studioが使用するバックアップおよび復元APIをトリガーするために、ツールがサポートするすべてのcmdletとパラメーターを一覧表示します。

バックアップストレージのcmdlet

Get-BckRstrStorage

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

パラメーター:

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

Set-BckRstrStorage

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

パラメーター:

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

テスト-バックアップリストアストレージ

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

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

CustomerAzureStorageの場合、テストはSAS URLが正しい権限を持ち、現在の日付がURLの開始日と終了日の範囲内にあることを検証します。

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

パラメーター:

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

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

ゲット-バックアップリストアバックアップ

バックアップまたは復元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 本番環境の種類: プロダクション、プロダクションガバメント、プロダクションJP、オンプレミス。
Quiet コンソールへの出力を抑制するためのパラメータ。

Get-BckRstrBackupsMembers

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

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

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

パラメーター:

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

Set-BckRstrUnpinBackups

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

パラメーター:

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

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

Remove-BckRstrBackup

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

パラメーター:

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

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

Get-BckRstrSchedules

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

パラメーター:

パラメーター Description
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を指定します。

パラメーター:

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

Set-BckRstrScheduleEnabled

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

パラメーター:

パラメーター Description
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 本番環境の種類: プロダクション、プロダクションガブ、プロダクションジェイピー、オンプレミス。
Quiet コンソールへの出力を抑制するパラメータ。
Name スケジュール名。
Uid スケジュール名を変更する場合。

バックアップの制限コマンドレット

Set-BckRstrOptions

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

パラメータ:

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

復元コマンドレット

Restore-BckRstrBackups

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

パラメータ:

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

履歴コマンドレット

Get-BckRstrHistory

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

パラメーター:

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

Get-BckRstrSpecificBackupHistory

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

パラメーター:

パラメーター 項目説明
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 本番環境の種類: 本番、政府機関向け本番環境、日本国内向け本番環境、オンプレミス。
Quiet コンソールへの出力を抑制するパラメーター。
BackupName バックアップの名前。.zip拡張子はオプションです。
Notes 設定または変更するメモ。
バックアップと復元のための自動構成ツールcmdlet