Azure Stack Hub オペレーター アクセス ワークステーション

オペレーター アクセス ワークステーション (OAW) は、Azure Stack Hub のハードウェア ライフサイクル ホスト (HLH) 上に、または Microsoft Hyper-V を実行するその他のマシン上に仮想マシン (VM) をデプロイするために使用されます。 オペレーターまたはユーザーのシナリオで使用するには、Azure Stack Hub エンドポイントへのネットワーク接続が必要です。

OAW VM は、オプションの仮想マシンであり、それが機能することを Azure Stack Hub によって必要とされていません。 その目的は、オペレーターまたはユーザーが Azure Stack Hub とやりとりするときに、彼らに最新のツールを提供することにあります。

OAW のシナリオ

次の表に OAW の一般的なシナリオを示します。 リモート デスクトップを使用して OAW に接続します。

プリインストールされているソフトウェア

次の表に、OAW VM にプレインストールされているソフトウェアを示します。

ファイルのダウンロード

OAW VM を作成するためのファイルを入手するには、ここからダウンロードしてください。 ダウンロードする前に、Microsoft プライバシー ステートメントと法律条項を必ず確認してください。

このソリューションのステートレスな性質により、OAW VM 向けの更新プログラムはありません。 マイルストーンごとに、VM イメージ ファイルの新しいバージョンがリリースされます。 新しい OAW VM を作成するには、最新バージョンを使用します。 このイメージ ファイルは、最新の Windows Server 2019 バージョンに基づいています。 インストール後、Windows Update を使用して、緊急更新プログラムを含む、更新プログラムを適用できます。

ダウンロードした OAW.zip ファイルのハッシュを検証して、OAW VM の作成に使用する前にそれが変更されていないことを確認します。 次の PowerShell スクリプトを実行します。 戻り値が True の場合、ダウンロードした OAW.zip を使用できます。

param(
    [Parameter(Mandatory=$True)]
    [ValidateNotNullOrEmpty()]
    [ValidateScript({Test-Path $_ -PathType Leaf})]
    [string]
    $DownloadedOAWZipFilePath
)
$expectedHash = '4B5CE0EA6FA12C4A95EBDE4223BEED5B9D98D7D9FC7DA1D5C72D3620725E5119'
$actualHash = (Get-FileHash -Path $DownloadedOAWZipFilePath).Hash
Write-Host "Expected hash: $expectedHash"
if ($expectedHash -eq $actualHash)
{
    Write-Host 'SUCCESS: OAW.zip file hash matches.'
}
else
{
    Write-Error "ERROR: OAW.zip file hash does not match! It isn't safe to use it, please download it again. Actual hash: $actualHash"
}

このスクリプトをお使いの環境にコピーするもう 1 つの方法は、 AzureStack-Tools で提供されている Test-FileHash コマンドレットを使用して、OAW.zip ファイルのハッシュを検証することです。

1. GitHub から Test-FileHash.psm1 ファイルをダウンロードして、次を実行します。

   Import-Module .\Test-FileHash.psm1 -Force -Verbose
   

2. Test-FileHash モジュールをインポートした後、OAW.zip ファイルのハッシュを確認します。

   Test-FileHash -ExpectedHash "4B5CE0EA6FA12C4A95EBDE4223BEED5B9D98D7D9FC7DA1D5C72D3620725E5119" -FilePath "<path to the OAW.zip file>"
   

HLH のバージョンを確認する

1. 自分の資格情報を使用して HLH にサインインします。

2. PowerShell ISE を開き、次のスクリプトを実行します。

   C:\Version\Get-Version.ps1
   

   次に例を示します。

   

スクリプトを使用して OAW VM を作成する

次のスクリプトでは、オペレーター アクセス ワークステーション (OAW) として仮想マシンを準備します。これは、Microsoft Azure Stack Hub にアクセスするために使用されます。

1. 自分の資格情報を使用して HLH にサインインします。

2. OAW.zip をダウンロードし、ファイルを抽出します。

3. 管理者特権の PowerShell セッションを開きます。

4. OAW.zip ファイルの抽出されたコンテンツに移動します。

5. New-OAW.ps1 スクリプトを実行します。

例: Microsoft イメージを使用して HLH 上にデプロイする

$oawRootPath = "D:\oawtest"
$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString

if (Get-ChildItem -Path $oawRootPath -Recurse | Get-Item -Stream Zone* -ErrorAction SilentlyContinue | Select-Object FileName)
{ Write-Host "Execution failed, unblock the script files first" }
else { .\New-OAW.ps1 -LocalAdministratorPassword $securePassword }

例: OEM イメージを使用して HLH 上にデプロイする

$oawRootPath = "D:\oawtest"
$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString

if (Get-ChildItem -Path $oawRootPath -Recurse | Get-Item -Stream Zone* -ErrorAction SilentlyContinue | Select-Object FileName)
{ Write-Host "Execution failed, unblock the script files first" }
else { .\New-OAW.ps1 -LocalAdministratorPassword $securePassword -AzureStackCertificatePath 'F:\certroot.cer' -DeploymentDataFilePath 'F:\DeploymentData.json' -AzSStampInfoFilePath 'F:\AzureStackStampInformation.json' }

AzureStackStampInformation.json ファイルに OAW VM の名前付けプレフィックスが含まれている場合、その値は VirtualMachineName パラメーターで使用されます。 その他の場合、既定の名前は AzSOAW またはユーザーが指定した任意の名前です。 AzureStackStampInformation.json が HLH 上に存在しない場合は、AzureStackStampInformation.jsonを使用してそれを再作成できます。

例: Microsoft Hyper-V 上にデプロイする

Microsoft Hyper-V を実行しているマシンには、4 つのコアと 2 GB の使用可能なメモリが必要です。 PowerShell コマンドレットは、ゲスト ネットワーク インターフェイスに IP 構成を適用せずに、OAW VM を作成します。 この例を使用して HLH で OAW をプロビジョニングする場合は、 デプロイ VM (DVM) によって最初に使用される IP アドレスを構成する必要があります。これは通常、BMC ネットワークの最後から2番目の IP アドレスです。

$oawRootPath = "D:\oawtest"
$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString

if (Get-ChildItem -Path $oawRootPath -Recurse | Get-Item -Stream Zone* -ErrorAction SilentlyContinue | Select-Object FileName)
{ Write-Host "Execution failed, unblock the script files first" }
else { .\New-OAW.ps1 -LocalAdministratorPassword $securePassword -AzureStackCertificatePath 'F:\certroot.cer' `-SkipNetworkConfiguration -VirtualSwitchName Example }

ユーザー アカウント ポリシー

OAW VM には、次のユーザー アカウント ポリシーが適用されます。

• ビルトイン Administrator のユーザー名: AdminUser
• MinimumPasswordLength = 14
• PasswordComplexity が有効
• MinimumPasswordAge = 1 (日)
• MaximumPasswordAge = 42 (日)
• NewGuestName = GUser (既定で無効)

New-OAW コマンドレットのパラメーター

OAW に対しては、2 つのパラメーター セットを使用できます。 省略可能なパラメーターは、角かっこ内に表示されます。

New-OAW
-LocalAdministratorPassword <Security.SecureString> `
[-AzureStackCertificatePath <String>] `
[-AzSStampInfoFilePath <String>] `
[-CertificatePassword <Security.SecureString>] `
[-ERCSVMIP <String[]>] `
[-DNS <String[]>] `
[-DeploymentDataFilePath <String>] `
[-SkipNetworkConfiguration] `
[-ImageFilePath <String>] `
[-VirtualMachineName <String>] `
[-VirtualMachineMemory <int64>] `
[-VirtualProcessorCount <int>] `
[-VirtualMachineDiffDiskPath <String>] `
[-PhysicalAdapterMACAddress <String>] `
[-VirtualSwitchName <String>] `
[-ReCreate] `
[-AsJob] `
[-Passthru] `
[-WhatIf] `
[-Confirm] `
[<CommonParameters>]

New-OAW
-LocalAdministratorPassword <Security.SecureString> `
-IPAddress <String> `
-SubnetMask <String> `
-DefaultGateway <String> `
-DNS <String[]> `
-TimeServer<String> `
[-AzureStackCertificatePath <String>] `
[-AzSStampInfoFilePath <String>] `
[-CertificatePassword <Security.SecureString>] `
[-ERCSVMIP <String[]>] `
[-ImageFilePath <String>] `
[-VirtualMachineName <String>] `
[-VirtualMachineMemory <int64>] `
[-VirtualProcessorCount <int>] `
[-VirtualMachineDiffDiskPath <String>] `
[-PhysicalAdapterMACAddress <String>] `
[-VirtualSwitchName <String>] `
[-ReCreate] `
[-AsJob] `
[-Passthru] `
[-WhatIf] `
[-Confirm] `
[<CommonParameters>]

次の表に、各パラメーターの定義を示します。

OAW VM のバージョンを確認する

1. 自分の資格情報を使用して OAW VM にサインインします。

2. PowerShell ISE を開き、次のスクリプトを実行します。

   C:\Version\Get-Version.ps1
   

   次に例を示します。

   

HLH と OAW の間でファイルを転送する

HLH と OAW の間でファイルを転送する必要がある場合は、New-SmbShare コマンドレットを使用して SMB 共有を作成します。 New-SmbShare により、ファイル システム フォルダーがサーバー メッセージ ブロック (SMB) 共有として、リモート クライアントに公開されます。 次に例を示します。

このコマンドレットによって作成された共有を削除するには、Remove-SmbShare コマンドレットを使用します。

OAW VM を削除する

次のスクリプトでは、管理と診断のために Azure Stack Hub へのアクセスに使用される OAW VM を削除します。 また、このスクリプトでは、その VM に関連付けられているディスク ファイルとガーディアンも削除します。

1. 自分の資格情報を使用して HLH にサインインします。

2. 管理者特権の PowerShell セッションを開きます。

3. インストールされている OAW.zip ファイルの抽出されたコンテンツに移動します。

4. Remove-OAW.ps1 スクリプトを実行して VM を削除します。

   .\Remove-OAW.ps1 -VirtualMachineName \<name\>
   

   <name> は、削除する仮想マシンの名前です。 既定では、この名前は AzSOAW です。

   次に例を示します。

   .\Remove-OAW.ps1 -VirtualMachineName AzSOAW
   

次のステップ

Azure Stack 管理タスク