Estação de trabalho de acesso do operador do Azure Stack Hub

A OAW (Estação de Trabalho de Acesso do Operador) é usada para implantar uma VM (máquina virtual) em um HLH (Host do Ciclo de Vida de Hardware) do Azure Stack Hub ou em qualquer outro computador que execute Microsoft Hyper-V. Ela exige que a conectividade de rede com os pontos de extremidade do Azure Stack Hub seja usada em cenários de operador ou de usuário.

A VM da OAW é uma máquina virtual opcional que não é exigida pelo Azure Stack Hub para funcionar. A finalidade dela é fornecer as ferramentas mais recentes para operadores ou usuários à medida que eles interagem com o Azure Stack Hub.

Cenários da OAW

As tabelas a seguir listam cenários comuns da OAW. Use a Área de Trabalho Remota para se conectar à OAW.

Software pré-instalado

A tabela a seguir lista o software pré-instalado na VM da OAW.

Baixar arquivos

Baixe aqui os arquivos para criar a VM da OAW. Examine a Política de Privacidade da Microsoft e os Termos Legais antes de baixar.

Devido à natureza sem estado da solução, não há atualizações para a VM da OAW. Para cada marco, uma nova versão do arquivo de imagem da VM é liberada. Use a última versão para criar uma VM da OAW. O arquivo de imagem é baseado na última versão do Windows Server 2019. Após a instalação, você pode aplicar atualizações, incluindo todas as atualizações críticas, usando o Windows Update.

Valide o hash do arquivo OAW.zip baixado para verificar se ele não foi modificado antes de usá-lo para criar a VM da OAW. Execute o script do PowerShell a seguir. Se o valor retornado for True, você poderá usar o OAW.zip baixado:

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

Outra maneira de copiar esse script para seu ambiente é usar o cmdlet Test-FileHash oferecido no AzureStack-Tools para verificar o hash do arquivo OAW.zip:

1. Baixe o arquivo Test-FileHash.psm1 no GitHub e execute:

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

2. Depois de importar o módulo Test-FileHash, verifique o hash do arquivo OAW.zip:

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

Verificar a versão do HLH

1. Entre no HLH com suas credenciais.

2. Abra o ISE do PowerShell e execute o seguinte script:

   C:\Version\Get-Version.ps1
   

   Por exemplo:

   

Criar a VM da OAW usando um script

O script a seguir prepara a máquina virtual como a OAW (Estação de Trabalho de Acesso ao Operador), que é usada para acessar o Microsoft Azure Stack Hub.

1. Entre no HLH com suas credenciais.

2. Baixe o OAW.zip e extraia os arquivos.

3. Abra uma sessão do PowerShell elevada.

4. Navegue até o conteúdo extraído do arquivo OAW.zip.

5. Execute o script New-OAW.ps1.

Exemplo: implantar no HLH usando uma imagem da 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 }

Exemplo: implantar no HLH usando uma imagem do 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 o AzureStackStampInformation.json arquivo incluir o prefixo de nomenclatura para VM OAW, esse valor será usado para o VirtualMachineName parâmetro . Caso contrário, o nome padrão é AzSOAW ou qualquer nome especificado pelo usuário. O AzureStackStampInformation.json pode ser recriado usando o ponto de extremidade privilegiado caso ele não esteja presente no HLH.

Exemplo: Implantar no Microsoft Hyper-V

O computador que executa Microsoft Hyper-V requer quatro (4) núcleos e dois (2) GB de memória disponível. Os cmdlets do PowerShell criarão a VM OAW sem aplicar uma configuração de IP ao adaptador de rede convidado. Se você usar o exemplo para provisionar o OAW em um HLH, deverá configurar o endereço IP originalmente usado pela VM de Implantação (DVM ), que normalmente é o segundo ao último IP da Rede 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 }

Política de conta de usuário

A seguinte política de conta de usuário é aplicada à VM OAW:

• Nome de usuário do administrador interno: AdminUser
• MinimumPasswordLength = 14
• PasswordComplexity está habilitado
• MinimumPasswordAge = 1 (dia)
• MaximumPasswordAge = 42 (dias)
• NewGuestName = GUser (desabilitado por padrão)

Parâmetros de cmdlet New-OAW

Dois conjuntos de parâmetros estão disponíveis para New-OAW. Parâmetros opcionais são mostrados entre colchetes.

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

A tabela a seguir lista a definição de cada parâmetro.

Verificar a versão da VM OAW

1. Entre na VM OAW com suas credenciais.

2. Abra o ISE do PowerShell e execute o seguinte script:

   C:\Version\Get-Version.ps1
   

   Por exemplo:

   

Transferir arquivos entre o HLH e o OAW

Se você precisar transferir arquivos entre o HLH e o OAW, crie um compartilhamento SMB usando o cmdlet New-SmbShare . New-SmbShare expõe uma pasta do sistema de arquivos a clientes remotos como um compartilhamento SMB (Bloco de Mensagens do Servidor). Por exemplo:

Para excluir um compartilhamento criado por esse cmdlet, use o cmdlet Remove-SmbShare .

Remover a VM OAW

O script a seguir remove a VM OAW, que é usada para acessar o Azure Stack Hub para administração e diagnóstico. Esse script também remove os arquivos de disco e o guardião associados à VM.

1. Entre no HLH com suas credenciais.

2. Abra uma sessão do PowerShell elevada.

3. Navegue até o conteúdo extraído do arquivo OAW.zip instalado.

4. Remova a VM executando o script Remove-OAW.ps1:

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

   Em que <nome> é o nome da máquina virtual a ser removida. Por padrão, o nome é AzSOAW.

   Por exemplo:

   .\Remove-OAW.ps1 -VirtualMachineName AzSOAW
   

Próximas etapas

Tarefas de Gerenciamento do Azure Stack