Workstation di accesso per l'operatore dell'hub di Azure Stack

La workstation di accesso dell'operatore (OAW) viene usata per distribuire una macchina virtuale (VM) in un host del ciclo di vita hardware dell'hub di Azure Stack (HLH) o in qualsiasi altro computer che esegue Microsoft Hyper-V. Richiede la connettività di rete agli endpoint dell'hub di Azure Stack da usare per gli scenari di operatore o utente.

La macchina virtuale OAW è una macchina virtuale facoltativa che non è richiesta per il funzionamento dell'hub di Azure Stack. Lo scopo è fornire gli strumenti più recenti agli operatori o agli utenti durante l'interazione con l'hub di Azure Stack.

Scenari di OAW

Le tabelle seguenti elencano gli scenari comuni per la workstation OAW. Usare Desktop remoto per connettersi alla workstation OAW.

Software preinstallato

La tabella seguente elenca il software preinstallato nella macchina virtuale OAW.

Scaricare i file

Per ottenere i file per creare la macchina virtuale OAW, scaricarli da qui. Assicurarsi di esaminare l'informativa sulla privacy e le condizioni legali di Microsoft prima di scaricare.

A causa della natura senza stato della soluzione, non sono disponibili aggiornamenti per la macchina virtuale OAW. Per ogni punto cardine viene rilasciata una nuova versione del file di immagine della macchina virtuale. Usare la versione più recente per creare una nuova macchina virtuale OAW. Il file di immagine si basa sulla versione più recente di Windows Server 2019. Dopo l'installazione è possibile applicare gli aggiornamenti, inclusi gli aggiornamenti critici, usando Windows Update.

Convalidare l'hash del file OAW.zip scaricato per assicurarsi che non sia stato modificato prima di usarlo per creare la macchina virtuale OAW. Eseguire lo script PowerShell seguente. Se il valore restituito è True, è possibile usare il file OAW.zip scaricato:

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"
}

Un altro modo per copiare questo script nell'ambiente consiste nell'usare il cmdlet Test-FileHash offerto in AzureStack-Tools per verificare l'hash del file OAW.zip:

1. Scaricare il file Test-FileHash.psm1 da GitHub e quindi eseguire:

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

2. Dopo aver importato il modulo Test-FileHash, verificare l'hash del file OAW.zip:

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

Controllare la versione dell'host HLH

1. Accedere all'host HLH con le credenziali personali.

2. Aprire Windows PowerShell ISE ed eseguire lo script seguente:

   C:\Version\Get-Version.ps1
   

   Ad esempio:

   

Creare la macchina virtuale OAW usando uno script

Lo script seguente prepara la macchina virtuale come workstation OAW (Operator Access Workstation), usata per accedere all'hub di Microsoft Azure Stack.

1. Accedere all'host HLH con le credenziali personali.

2. Scaricare OAW.zip ed estrarre i file.

3. Aprire una sessione di PowerShell con privilegi elevati.

4. Passare al contenuto estratto del file OAW.zip.

5. Eseguire lo script New-OAW.ps1.

Esempio: Distribuire nell'host HLH usando un'immagine Microsoft

$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 }

Esempio: Distribuire nell'host HLH usando un'immagine OEM

$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' }

Se il AzureStackStampInformation.json file include il prefisso di denominazione per la macchina virtuale OAW, tale valore verrà usato per il VirtualMachineName parametro. In caso contrario, il nome predefinito è AzSOAW o qualsiasi nome specificato dall'utente. L'oggetto AzureStackStampInformation.json può essere ricreato usando l'endpoint con privilegi nel caso in cui non sia presente nell'HLH.

Esempio: Distribuire in Microsoft Hyper-V

Il computer che esegue Microsoft Hyper-V richiede quattro core (4) e due (2) GB di memoria disponibile. I cmdlet di PowerShell creeranno la macchina virtuale OAW senza applicare una configurazione IP all'interfaccia di rete guest. Se si usa l'esempio per effettuare il provisioning dell'OAW in un HLH, è necessario configurare l'indirizzo IP originariamente usato dalla macchina virtuale di distribuzione (DVM), che in genere è il secondo all'ultimo indirizzo IP della rete BMC.

$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 }

Criteri dell'account utente

I criteri dell'account utente seguenti vengono applicati alla macchina virtuale OAW:

• Nome utente amministratore predefinito: AdminUser
• MinimumPasswordLength = 14
• PasswordComplexity è abilitato
• MinimumPasswordAge = 1 (giorno)
• MaximumPasswordAge = 42 (giorni)
• NewGuestName = GUser (disabilitato per impostazione predefinita)

Parametri del cmdlet New-OAW

Per New-OAW sono disponibili due set di parametri. I parametri facoltativi vengono visualizzati tra parentesi quadre.

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>]

Nella tabella seguente viene elencata la definizione per ogni parametro.

Controllare la versione della macchina virtuale OAW

1. Accedere alla macchina virtuale OAW con le credenziali.

2. Aprire Windows PowerShell ISE ed eseguire lo script seguente:

   C:\Version\Get-Version.ps1
   

   Ad esempio:

   

Trasferire file tra HLH e OAW

Se è necessario trasferire file tra HLH e OAW, creare una condivisione SMB usando il cmdlet New-SmbShare . New-SmbShare espone una cartella del file system ai client remoti come condivisione SMB (Server Message Block). Ad esempio:

Per eliminare una condivisione creata da questo cmdlet, usare il cmdlet Remove-SmbShare .

Rimuovere la macchina virtuale OAW

Lo script seguente rimuove la macchina virtuale OAW, usata per accedere all'hub di Azure Stack per l'amministrazione e la diagnostica. Questo script rimuove anche i file del disco e il guardiano associato alla macchina virtuale.

1. Accedere a HLH con le credenziali.

2. Aprire una sessione di PowerShell con privilegi elevati.

3. Passare al contenuto estratto del file OAW.zip installato.

4. Rimuovere la macchina virtuale eseguendo lo script Remove-OAW.ps1:

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

   Dove <name> è il nome della macchina virtuale da rimuovere. Per impostazione predefinita, il nome è AzSOAW.

   Ad esempio:

   .\Remove-OAW.ps1 -VirtualMachineName AzSOAW
   

Passaggi successivi

Attività di gestione di Azure Stack