PowerShell を使用してコマンド ラインから ASDK をデプロイする
Azure Stack Development Kit (ASDK) は、Azure Stack の機能やサービスを評価したり、実演したりするためにデプロイできるテスト/開発環境です。 それを稼働させるには、環境ハードウェアを用意し、いくつかのスクリプトを実行する必要があります。 このスクリプトは実行に数時間かかります。 その後、管理者ポータルとユーザー ポータルにサインインし、Azure Stack の使用を開始することができます。
前提条件
ASDK ホスト コンピューターを準備します。 ハードウェア、ソフトウェア、およびネットワークを計画します。 ASDK をホストするコンピューターでは、ハードウェア、ソフトウェア、ネットワークの要件を満たす必要があります。 Microsoft Entra ID または Active Directory フェデレーション サービス (AD FS) (AD FS) の使用を選択します。 インストール プロセスが滞りなく進行するように、デプロイの開始前にこれらの前提条件に従ってください。
ASDK をデプロイする前に、計画している ASDK ホスト コンピューターのハードウェア、オペレーティング システム、アカウント、およびネットワーク構成が、ASDK をインストールするための最小要件を満たしていることを確認してください。
デプロイ パッケージをダウンロードし、展開する
ASDK ホスト コンピューターが ASDK の基本的なインストール要件を満たしていることを確認したら、次の手順は ASDK デプロイ パッケージをダウンロードして展開することです。 デプロイ パッケージには、Cloudbuilder.vhdx ファイルが含まれています。このファイルは、起動可能なオペレーティング システムと Azure Stack インストール ファイルを含む仮想ハード ドライブです。
ASDK ホストや別のコンピューターに、デプロイ パッケージをダウンロードできます。 展開されたデプロイ ファイルは 60 GB の空きディスク容量を占めます。そのため、別のコンピューターを利用することで、ASDK ホストのハードウェア要件を緩和できます。
Azure Stack Development Kit (ASDK) をダウンロードして展開する
ASDK ホスト コンピューターの準備
ASDK をホスト コンピューターにインストールする前に、環境を準備し、VHD から起動するようにシステムを構成する必要があります。 この手順の後、ASDK ホストは Cloudbuilder.vhdx (起動可能なオペレーティング システムと Azure Stack インストール ファイルを含む仮想ハード ドライブ) から起動します。
PowerShell を使用して、CloudBuilder.vhdx から起動するように ASDK ホスト コンピューターを構成します。 これらのコマンドは、ダウンロードして展開した Azure Stack 仮想ハード ディスク (CloudBuilder.vhdx) から起動するように ASDK ホスト コンピューターを構成します。 以下の手順の完了後、ASDK ホスト コンピューターを再起動します。
CloudBuilder.vhdx から起動するように ASDK ホスト コンピューターを構成するには、次の手順に従います。
- 管理者としてコマンド プロンプトを起動します。
bcdedit /copy {current} /d "Azure Stack"を実行します。- 返された CLSID 値を、必要な中かっこ (
{}) を含めてコピー (Ctrl + C) します。 この値は{CLSID}と呼ばれ、後の手順で貼り付ける (Ctrl + V または右クリック) 必要があります。 bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdxを実行します。bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdxを実行します。bcdedit /set {CLSID} detecthal onを実行します。bcdedit /default {CLSID}を実行します。- 起動設定を確認するには、
bcdeditを実行します。 - CloudBuilder.vhdx ファイルが C:\ ドライブのルートに移動されている (
C:\CloudBuilder.vhdx) ことを確認し、ASDK ホスト コンピューターを再起動します。 ASDK ホスト コンピューターが再起動されるときに、ASDK のデプロイを開始するには、CloudBuilder.vhdx 仮想マシン (VM) のハード ドライブから起動する必要があります。
重要
再起動する前に、ASDK ホスト コンピューターへの直接の物理的アクセスまたは KVM アクセスがあることを確認してください。 VM が初めて起動するときに、Windows Server セットアップを完了するように求めるメッセージが表示されます。 ASDK ホスト コンピューターにログインするときに使用したのと同じ管理者資格情報を入力します。
PowerShell を使用して ASDK ホストを準備する
ASDK ホスト コンピューターが CloudBuilder.vhdx イメージから正常に起動したら、ASDK ホスト コンピューターへのログインに使用した同じローカル管理者資格情報を使用してサインインします。 さらに、ホスト コンピューターが VHD から起動したときに Windows Server セットアップの実行の一環として指定した同じ資格情報もあります。
注意
必要に応じて、ASDK のインストール "前" に Azure Stack のテレメトリ設定を構成することもできます。
管理者特権の PowerShell コンソールを開いてこのセクションのコマンドを実行し、ASDK を ASDK ホストにデプロイします。
重要
ASDK のインストールでは、ネットワーク用に 1 つだけの NIC (ネットワーク インターフェイス カード) がサポートされています。 NIC が複数ある場合は、デプロイ スクリプトを実行する前に、1 つのみが有効になっている (他はすべて無効になっている) ことを確認します。
MICROSOFT ENTRA ID を使用して Azure Stack をデプロイすることも、ID プロバイダーとして FS をWindows Server ADすることもできます。 どちらを使用しても、Azure Stack、リソース プロバイダー、およびその他のアプリは同様に動作します。
ヒント
セットアップ パラメーター (InstallAzureStackPOC.ps1 のオプションのパラメーターと以下の例を参照) を指定しない場合、必須パラメーターの入力を求めるメッセージが表示されます。
Microsoft Entra ID を使用して Azure Stack をデプロイする
id プロバイダーとして Microsoft Entra ID を使用して Azure Stack をデプロイするには、インターネット接続を直接または透過的なプロキシ経由で行う必要があります。
次の PowerShell コマンドを実行して、Microsoft Entra ID を使用して ASDK をデプロイします。
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password
ASDK のインストールまで数分で、資格情報のMicrosoft Entraを求められます。 Microsoft Entra テナントのグローバル管理者資格情報を指定します。
デプロイ後、グローバル管理者アクセス許可Microsoft Entra必要ありません。 ただし、一部の操作では、全体管理者の資格情報が必要な場合があります。 そのような操作の例には、リソース プロバイダーのインストーラー スクリプトや、アクセス許可を付与する必要のある新機能などがあります。 アカウントの全体管理者のアクセス許可を一時的に復元するか、既定のプロバイダー サブスクリプションの所有者である別の全体管理者アカウントを使用します。
AD FS を使用して Azure Stack をデプロイする
AD FS を ID プロバイダーとして使用して ASDK をデプロイするには、次の PowerShell コマンドを実行します (-UseADFS パラメーターを追加するだけです)。
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS
AD FS デプロイでは、既定のスタンプ ディレクトリ サービスが ID プロバイダーとして使用されます。 サインインに使用する既定のアカウントは azurestackadmin@azurestack.local で、パスワードは PowerShell のセットアップ コマンドの一部として指定したものに設定されます。
デプロイ処理には数時間かかる場合があります。その間に、システムは自動的に 1 回再起動されます。 デプロイが成功すると、PowerShell コンソールに次のように表示されます:COMPLETE:Action 'Deployment' (完了: アクション 'デプロイ') 。 デプロイが失敗した場合は、-rerun パラメーターを使用してスクリプトを再実行してみてください。 または、最初から ASDK を再デプロイすることもできます。
重要
ASDK ホストの再起動後にデプロイの進行状況を監視する場合は、AzureStack\AzureStackAdmin としてサインインする必要があります。 ホスト コンピューターが再起動され、azurestack.local ドメインに参加した後、ローカル管理者としてサインインすると、デプロイの進行状況は表示されません。 デプロイは再実行せず、代わりにローカル管理者と同じパスワードを使用して AzureStack\AzureStackAdmin としてサインインし、セットアップが実行中であることを確認します。
Microsoft Entraデプロイ スクリプトの例
Microsoft Entraデプロイ全体をスクリプト化できます。 オプションのパラメーターを含む、コメント付きの例をいくつか示します。
Microsoft Entra ID が 1 つのMicrosoft Entra ディレクトリにのみ関連付けられている場合:
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
$aadcred = Get-Credential "<Azure AD global administrator account name>"
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.
Microsoft Entra ID が複数のMicrosoft Entra ディレクトリに関連付けられている場合:
cd C:\CloudDeployment\Setup
$adminpass = Get-Credential Administrator
$aadcred = Get-Credential "<Azure AD global administrator account name>" #Example: user@AADDirName.onmicrosoft.com
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -InfraAzureDirectoryTenantName "<Azure AD directory in the form of domainname.onmicrosoft.com or an Azure AD verified custom domain name>" -TimeServer 52.168.138.145 #Example time server IP address.
自分の環境で DHCP を有効にしていない場合は、上のいずれかのオプションに以下の追加パラメーターを含める必要があります (使用例を示しています)。
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26
ASDK InstallAzureStackPOC.ps1 の省略可能なパラメーター
| パラメーター | 必須/省略可能 | 説明 |
|---|---|---|
| AdminPassword | 必須 | ASDK のデプロイの一環として作成されたすべての仮想マシンのローカル管理者アカウントと他のすべてのユーザー アカウントを設定します。 このパスワードは、ホスト上の現在のローカル管理者パスワードと一致する必要があります。 |
| InfraAzureDirectoryTenantName | 必須 | テナント ディレクトリを設定します。 このパラメーターを使用して、Microsoft Entra アカウントに複数のディレクトリを管理するアクセス許可がある特定のディレクトリを指定します。 .onmicrosoft.com 形式のMicrosoft Entra テナントの完全名、またはMicrosoft Entra ID 検証済みカスタム ドメイン名。 |
| TimeServer | 必須 | このパラメーターを使用して、特定のタイム サーバーを指定します。 このパラメーターは、有効なタイム サーバーの IP アドレスとして指定する必要があります。 サーバー名はサポートされていません。 |
| InfraAzureDirectoryTenantAdminCredential | 省略可能 | Microsoft Entraユーザー名とパスワードを設定します。 これらの Azure 資格情報は、組織 ID である必要があります。 |
| InfraAzureEnvironment | 省略可能 | この Azure Stack デプロイを登録する Azure 環境を選択します。 オプションには、グローバル Azure、Azure China、Azure US Government などがあります。 |
| DNSForwarder | 省略可能 | DNS サーバーが Azure Stack のデプロイの一部として作成されます。 ソリューション内のコンピューターにスタンプ外の名前解決を許可するには、既存のインフラストラクチャの DNS サーバーを提供します。 スタンプ内の DNS サーバーが、このサーバーに不明な名前解決の要求を送信します。 |
| Rerun | 省略可能 | このフラグを使用して、デプロイを再実行します。 以前のすべての入力が使用されます。 以前に指定したデータの再入力は、サポートされていません。いくつかの一意の値が生成され、デプロイに使用されるためです。 |
デプロイ後の構成を実行する
ASDK をインストールした後、推奨されるインストール後の確認と構成変更がいくつかあります。 test-AzureStack コマンドレットを使用してインストールが正常に行われたことを検証してから、Azure Stack PowerShell および GitHub ツールをインストールします。
評価期間が終了する前に ASDK ホストのパスワードが期限切れにならないように、パスワードの有効期限のポリシーをリセットすることをお勧めします。
注意
必要に応じて、ASDK のインストール "後" に Azure Stack のテレメトリ設定を構成することもできます。
Azure に登録する
Azure Stack に Azure Marketplace 項目をダウンロードできるように、Azure Stack を Azure に登録する必要があります。
次のステップ
お疲れさまでした。 これらの手順を完了すると、管理ポータル (https://adminportal.local.azurestack.external) とユーザー ポータル (https://portal.local.azurestack.external) の両方で ASDK 環境を利用できるようになります。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示