Citrix.Image.Uploader PowerShell モジュール
本ドキュメントでは、Citrix.Image.Uploader PowerShell モジュールのインストール、更新、およびアンインストールの基本的な手順について説明します。このモジュールは、SMB ファイル共有から指定されたターゲット環境に VHD(x) をアップロードする機能を提供します。
関連するコマンドレットと使用例の詳細については、以下のドキュメントを参照してください。
ライブラリとモジュールのインストール
Image Portability は、ポータビリティ操作を実行するために Microsoft PowerShell Gallery のライブラリを使用します。
Citrix.Image.Uploader モジュールの最新バージョンをインストールするには、次の PowerShell コマンドを実行します。
Install-Module -Name "Citrix.Image.Uploader" -Scope CurrentUser
<!--NeedCopy-->
Citrix.Image.Uploader モジュールの特定のバージョンをインストールするには、次の PowerShell コマンドを実行します。
Install-Module -Name "Citrix.Image.Uploader" -RequiredVersion 1.0.0 -Scope CurrentUser
<!--NeedCopy-->
モジュールが正常にインストールされたことを確認するには、次のコマンドを実行します。
Get-InstalledModule -Name "Citrix.Image.Uploader"
<!--NeedCopy-->
このコマンドは、次のような出力を返します。
| 名前 | リポジトリ | 説明 |
|---|---|---|
| Citrix.Image.Uploader | PSGallery | VHD(x) を Azure ストレージアカウント、AWS、または GCP にアップロードし、VHD(x) に関する情報を取得するコマンド |
モジュールの最新バージョンへの更新
モジュールを最新バージョンに更新するには、次のコマンドを実行します。
Update-Module -Name "Citrix.Image.Uploader" -Force
<!--NeedCopy-->
Citrix.Image.Uploader モジュールの特定のバージョンに更新するには、次のコマンドを実行します。
Update-Module -Name "Citrix.Image.Uploader" -RequiredVersion 1.0.0
<!--NeedCopy-->
プラットフォーム固有のサードパーティコンポーネントのインストール
Image Portability PowerShell モジュールは、サードパーティの依存関係をインストールしません。そのため、インストールをターゲットとするプラットフォームのみに限定できます。以下のいずれかのプラットフォームを使用している場合は、プラットフォームの依存関係のインストールに関する関連手順に従ってください。
注:
サードパーティコンポーネントのインストールは、Citrix.Image.Uploader PowerShell モジュールを使用する場合にのみ必要です。これらは、エクスポートまたは準備タスクの実行には不要です。
Azure
Azure にイメージをアップロードする場合は、Azure コマンドラインユーティリティをダウンロードしてインストールし、次のコマンドを実行して必要な Azure PowerShell モジュールをインストールします。
Install-Module -Name Az.Accounts -Scope CurrentUser -AllowClobber -Force
Install-Module -Name Az.Compute -Scope CurrentUser -AllowClobber –Force
<!--NeedCopy-->
ライブラリとモジュールのアンインストール
モジュールをアンインストールするには、次のコマンドを実行します。
Get-InstalledModule -Name "Citrix.Image.Uploader" | Uninstall-Module
<!--NeedCopy-->
Citrix.Image.Uploader モジュールの特定のバージョンをアンインストールするには、次のコマンドを実行します。
Uninstall-Module -Name "Citrix.Image.Uploader" -RequiredVersion 1.0.0
<!--NeedCopy-->
注:
サードパーティのスクリプトとコンポーネントは、IPS モジュールをアンインストールしても自動的に削除されません。
基本的な使用法と例
モジュールがインストールされたら、次のコマンドを実行して Citrix.Image.Uploader PowerShell モジュールで利用可能なコマンドを表示できます。
Get-Command -Module "Citrix.Image.Uploader"
<!--NeedCopy-->
特定のコマンドに関する詳細情報 (説明や使用例を含む) を取得するには、次を使用します。
Get-Help <Command-Name> -Full
<!--NeedCopy-->
現在のコマンドと使用例の完全なリストについては、以下のドキュメントを参照してください。