テスト パッケージのガイドライン

重要

Microsoft 365 のテスト ベースは、2024 年 5 月 31 日に終了 (EOL) に移行されます。 私たちは、可能な限りスムーズに移行するためのサポートとガイダンスを提供するために、各顧客と緊密に協力することにコミットしています。 質問、懸念事項、またはサポートが必要な場合は、 サポート リクエストを送信してください。

1. スクリプト参照

.zip ファイルをポータルにアップロードすると、そのファイルのすべてのコンテンツがルート フォルダーに解凍されます。 この最初の解凍操作を行うためにコードを記述する必要はありません。 また、アップロードされた zip ファイルを基準としたパスを使用して、.zip 内の任意のファイルを参照することもできます。

次の例では、[タスク] タブの入力フィールドからバイナリ/スクリプトを参照する方法を示します。青色のテキストは、引用符なしで[スクリプト パス] フィールドに入力する必要があります。

アップロードする前に、zip ファイル内のコンテンツを認識することが重要です。 多くの場合、フォルダーを圧縮する場合、ローカル コンピューターは zip ファイルの下にメイン フォルダーを作成します。 この場合、参照元は次の 太字 のようになります。

Contoso_App_Folder.zip:

├── Contoso_App_Folder

│   ├── file1.exe

│   ├── ScriptX.ps1

│   ├── folder1

│      ├── file3.exe

│      ├── script.ps1

• ScriptX.ps1 - "Contoso_App_Folder/ScriptX.ps1"
• Script.ps1 - "Contoso_App_Folder/folder1/script.ps1"

また、zip ファイルの下にファイルまたはコンテンツが含まれる場合があります (たとえば、2 番目のレベルのフォルダーはありません)。

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1

• ScriptX.ps1 - "ScriptX.ps1"
• Script.ps1 - "folder1/script.ps1"

2. スクリプトの実行

すぐに使用するテスト: アプリケーション パッケージには、少なくとも 3 つの PowerShell スクリプトが含まれている必要があります。 これらのスクリプトは、アプリケーションとその依存関係の無人インストール、起動、終了を実行します。 各スクリプトは、独自の前提条件のチェック、独自の成功の検証、およびそれ自体の後のクリーンアップ (必要な場合) を処理する必要があります。

機能テスト: アプリケーション パッケージには、少なくとも 1 つの PowerShell スクリプトが含まれている必要があります。 複数のスクリプトが指定されている場合、スクリプトはアップロード シーケンスで実行され、特定のスクリプトでエラーが発生すると、後続のスクリプトの実行が停止します。

スクリプトの要件

• PowerShell バージョン 5.1 以降
• 無人実行
• エラー戻りコード
• 成功を検証する
• 特定のログ フォルダーをスクリプト化するためのログ記録

各スクリプトは、テスト パイプラインで正常に実行するには、無人 (ユーザー プロンプトなし) を実行する必要があります。

注:

スクリプトは、正常に完了すると "0" を返し、実行中にエラーが発生した場合は 0 以外のエラー コードを返す必要があります。

各スクリプトは、正常に実行されたことを検証する必要があります。 たとえば、インストール スクリプトは、インストーラー バイナリの実行が完了した後、システムに特定のバイナリやレジストリ キーが存在するためにチェックする必要があります。 このチェックは、インストールが成功したことを適切な程度の信頼度で確保するのに役立ちます。

検証は、テストの実行中にエラーが発生した場所を適切に診断するために必要です。 たとえば、スクリプトがアプリケーションを正常にインストールできない場合と、アプリケーションを起動できない場合などです。

重要

次の手順は避けてください。

• スクリプトはマシンを再起動しないでください。再起動が必要な場合は、スクリプトのアップロード中にこれを指定してください。
• Windows IP 構成で DNS サフィックス検索リストを変更しないでください。

重要

使用可能な最大ディスク領域は 127 Gb です。 この容量を超える領域を消費するパッケージは実行されません。

重要

Windows UI と対話するパッケージでは、正しく実行するには、自動ログオン資格情報が有効になっている必要があります。

重要

パッケージ内のスクリプトはすべて、実行時間制限が 60 分です。 60 分後のスクリプトの実行はタイムアウトになります。

3. ログ収集

各スクリプトは、生成されたすべてのログを という名前 logsのフォルダーに出力する必要があります。 という名前 logs のディレクトリ内のすべてのフォルダーがコピーされ、ページにダウンロード用に Test Results 表示されます。

たとえば、インストール スクリプト ( App/scripts/install ディレクトリ内にある可能性があります) では、 ログをログ/install.logに出力できます。最終的なログは Apps /scripts/install/logs/install.log

システムは、他logsのフォルダー内の他のinstall.logファイルと共にファイルを選択し、ダウンロードのために照合します。

4. アプリケーション バイナリ

バイナリと依存関係は、1 つの zip ファイルに含める必要があります。

これらのバイナリには、アプリケーションのインストールに必要なすべてのものが含まれている必要があります (アプリケーション インストーラーなど)。 アプリケーションが .NET Core/Standard や .NET Framework などのフレームワークに依存している場合は、これらのフレームワークをファイルに含め、指定されたスクリプトで正しく参照する必要があります。

注:

アップロードされた zip ファイルの名前にスペースや特殊文字を含めることはできません

5. アプリケーション/テスト ルール

アプリケーション/テストをテスト ベース インフラストラクチャの下で正しく実行するには、「 アプリケーション/テスト ルール」で説明されている規則に準拠する必要があります。

次の手順

次の記事に進み、よく寄せられる質問 (FAQ) を確認してください

次の手順