Åtkomst till arbetsstation för Azure Stack Hub-operatör

OAW (Operator Access Workstation) används för att distribuera en virtuell dator (VM) på en Azure Stack Hub-värd för maskinvarulivscykel (HLH) eller någon annan dator som kör Microsoft Hyper-V. Det kräver att nätverksanslutningen till Azure Stack Hub-slutpunkterna används för operatörs- eller användarscenarier.

Den virtuella OAW-datorn är en valfri virtuell dator som inte krävs av Azure Stack Hub för att fungera. Syftet är att tillhandahålla de senaste verktygen till operatörer eller användare när de interagerar med Azure Stack Hub.

OAW-scenarier

I följande tabeller visas vanliga scenarier för OAW. Använd Fjärrskrivbord för att ansluta till OAW.

Scenario	Beskrivning
Öppna administrationsportalen	Utföra administrativa åtgärder.
Åtkomst PEP	Logginsamling och uppladdning: -Skapa en SMB-resurs på HLH för filöverföring från Azure Stack Hub. -Använd Azure Storage Explorer för att ladda upp loggar som sparats till SMB-resursen.
Registrera Azure Stack Hub	För omregistrering hämtar du tidigare registreringsnamn och resursgrupp från administrationsportalen.
Marketplace-syndikering	Skapa en SMB-resurs på HLH för att lagra den nedladdade avbildningen eller tillägget.
Skapa Virtual Machines	Skapa virtuella datorer med Azure CLI.
Hantera AKS	Hantera AKS-kluster, till exempel skala eller uppgradera.

Förinstallerad programvara

I följande tabell visas den förinstallerade programvaran på den virtuella OAW-datorn.

Programvarunamn	Plats
Microsoft Edge för företag	[SystemDrive]\Program Files (x86)\Microsoft\Edge\Application
Az-moduler	[SystemDrive]\ProgramFiles\WindowsPowerShell\Modules
PowerShell 7	[SystemDrive]\Program Files\PowerShell\7
Kommandoradsgränssnitt för Azure (CLI)	[SystemDrive]\Program Files (x86)\Microsoft SDK:er\Azure\CLI2
Microsoft Azure Storage Explorer	[SystemDrive]\Program Files (x86)\Microsoft Azure Storage Explorer
AzCopy	[SystemDrive]\VMSoftware\azcopy_windows_amd64_*
AzureStack-Tools	[SystemDrive]\VMSoftware\AzureStack-Tools

Ladda ned filer

Hämta filerna för att skapa den virtuella OAW-datorn genom att ladda ned här. Se till att granska Microsofts sekretesspolicy och juridiska villkor innan du laddar ned.

På grund av lösningens tillståndslösa natur finns det inga uppdateringar för den virtuella OAW-datorn. För varje milstolpe släpps en ny version av VM-avbildningsfilen. Använd den senaste versionen för att skapa en ny virtuell OAW-dator. Avbildningsfilen baseras på den senaste versionen av Windows Server 2019. Efter installationen kan du tillämpa uppdateringar, inklusive eventuella kritiska uppdateringar, med hjälp av Windows Update.

Verifiera hashen för den nedladdade OAW.zip filen för att kontrollera att den inte har ändrats innan du använder den för att skapa den virtuella OAW-datorn. Kör följande PowerShell-skript. Om returvärdet är True kan du använda den nedladdade OAW.zip:

Anteckning

Avblockera skriptfilerna när nedladdningen har extraherats.

param(
    [Parameter(Mandatory=$True)]
    [ValidateNotNullOrEmpty()]
    [ValidateScript({Test-Path $_ -PathType Leaf})]
    [string]
    $DownloadedOAWZipFilePath
)
$expectedHash = '73BE1564EE7357691A44DB3BD01AD5BB931CD029DE613EC6F564E8CDEA59F09D'
$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"
}

Ett annat sätt att kopiera det här skriptet till din miljö är att använda den Test-FileHash-cmdlet som erbjuds i AzureStack-Tools för att verifiera hashen för OAW.zip-filen:

1. Ladda ned filen Test-FileHash.psm1 från GitHub och kör sedan:

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

2. När du har importerat Test-FileHash-modulen kontrollerar du hashen för OAW.zip-filen:

   Test-FileHash -ExpectedHash "73BE1564EE7357691A44DB3BD01AD5BB931CD029DE613EC6F564E8CDEA59F09D" -FilePath "<path to the OAW.zip file>"
   

Kontrollera HLH-versionen

Anteckning

Det här steget är viktigt för att avgöra om du distribuerar OAW på en HLH som har distribuerats med en Microsoft-avbildning eller en OEM-avbildning. Denna PowerShell-cmdlet finns inte på en HLH som har distribuerats med en OEM-avbildning. Om du distribuerar OAW på en allmän Microsoft Hyper-V kan du hoppa över det här steget.

1. Logga in på HLH med dina autentiseringsuppgifter.

2. Öppna PowerShell ISE och kör följande skript:

   C:\Version\Get-Version.ps1
   

   Exempel:

   

Skapa den virtuella OAW-datorn med hjälp av ett skript

Följande skript förbereder den virtuella datorn som OAW (Operator Access Workstation), som används för att komma åt Microsoft Azure Stack Hub.

1. Logga in på HLH med dina autentiseringsuppgifter.

2. Ladda ned OAW.zip och extrahera filerna.

3. Öppna en upphöjd PowerShell-session.

4. Navigera till det extraherade innehållet i OAW.zip-filen.

5. Kör skriptet New-OAW.ps1.

Exempel: Distribuera på HLH med en Microsoft Image

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

Exempel: Distribuera på HLH med en OEM-avbildning

$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 Om filen innehåller namngivningsprefixet för den virtuella OAW-datorn används det värdet för parametern VirtualMachineName . Annars är AzSOAW standardnamnet eller det namn som anges av användaren. AzureStackStampInformation.json kan återskapas med hjälp av den privilegierade slutpunkten om den inte finns på HLH.

Anteckning

Parametern AzureStackCertificatePath bör endast användas när Azure Stack Hub distribuerades med hjälp av certifikat som utfärdats från en företagscertifikatutfärdare. Om inte är tillgängligt kontaktar du maskinvarupartnern DeploymentData.json för att hämta den eller fortsätta med exempeldistributionen på Microsoft Hyper-V.

Exempel: Distribuera på Microsoft Hyper-V

Datorn som kör Microsoft Hyper-V kräver fyra (4) kärnor och två (2) GB tillgängligt minne. PowerShell-cmdletarna skapar den virtuella OAW-datorn utan att tillämpa en IP-konfiguration på gästnätverksgränssnittet. Om du använder exemplet för att etablera OAW på en HLH måste du konfigurera den IP-adress som ursprungligen användes av den virtuella distributionsdatorn (DVM), vilket vanligtvis är den näst sista IP-adressen för BMC-nätverket.

Exempel	Ips
BMC-nätverk	10.26.5.192/26
First Host IP	10.26.5.193
Ip-adress för senaste värd	10.26.5.254
DVM/OAW IP	10.26.5.253
Nätmask	255.255.255.192
Standardgateway	10.26.5.193

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

Anteckning

Parametern AzureStackCertificatePath bör endast användas när Azure Stack Hub distribuerades med hjälp av certifikat som utfärdats från en företagscertifikatutfärdare. Den virtuella OAW-datorn distribueras utan en nätverkskonfiguration. Du kan konfigurera en statisk IP-adress eller hämta en IP-adress via DHCP.

Användarkontoprincip

Följande användarkontoprincip tillämpas på den virtuella OAW-datorn:

• Inbyggt administratörsanvändarnamn: AdminUser
• MinimumPasswordLength = 14
• PasswordComplexity är aktiverat
• MinimumPasswordAge = 1 (dag)
• MaximumPasswordAge = 42 (dagar)
• NewGuestName = GUser (inaktiverad som standard)

Parametrar för new-OAW-cmdlet

Två parameteruppsättningar är tillgängliga för New-OAW. Valfria parametrar visas inom hakparenteser.

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

I följande tabell visas definitionen för varje parameter.

Parameter	Obligatorisk/valfri	Beskrivning
LocalAdministratorPassword	Obligatorisk	Lösenord för den virtuella datorns lokala administratörskonto AdminUser.
IPAddress	Obligatorisk	Den statiska IPv4-adressen för att konfigurera TCP/IP på den virtuella datorn.
Undernätmask	Obligatorisk	IPv4-nätmasken för att konfigurera TCP/IP på den virtuella datorn.
DefaultGateway	Obligatorisk	IPv4-adressen för standardgatewayen för att konfigurera TCP/IP på den virtuella datorn.
DNS	Obligatorisk	DNS-servrar för att konfigurera TCP/IP på den virtuella datorn.
TimeServer	Obligatorisk	IP-adressen för tidsservern som Azure Stack Hub synkroniserar från, vilket också är den tidskälla som OAW synkroniserar från. Kontrollera AzureStackStampInformation.json eller be administratören om IP-adressen för den tidsserver som hubben synkroniserar från. Om det är brådskande och du inte kunde hämta IP-adressen för den tidsserver som hubben synkroniserar från kan du ange standardtidsservern time.windows.com 0x8 för den här parametern. Observera att det rekommenderas starkt att se till att tiden i OAW och Hub är synkroniserad för att undvika potentiella problem med klocksnedställning när du arbetar i en OAW för att interagera med hubben.
ImageFilePath	Valfritt	Sökvägen till OAW.vhdx som tillhandahålls av Microsoft. Standardvärdet är OAW.vhdx under samma överordnade mapp i det här skriptet.
VirtualMachineName	Valfritt	Namnet som ska tilldelas till den virtuella datorn. Om namnprefixet finns i filen DeploymentData.json används det som standardnamn. Annars används AzSOAWsom standardnamn. Du kan ange ett annat namn för att skriva över standardvärdet.
VirtualMachineMemory	Valfritt	Minne som ska tilldelas till den virtuella datorn. Standardvärdet är 2 GB.
VirtualProcessorCount	Valfritt	Antal virtuella processorer som ska tilldelas till den virtuella datorn. Standardvärdet är 4.
VirtualMachineDiffDiskPath	Valfritt	Sökväg för att lagra temporära diffdiskfiler medan den virtuella hanteringsdatorn var aktiv. Standardvärdet är underkatalogen DiffDisks under samma överordnade mapp i det här skriptet.
AzureStackCertificatePath	Valfritt	Sökväg till certifikat som ska importeras till den virtuella datorn för Azure Stack Hub-åtkomst.
AzSStampInfoFilePath	Valfritt	Sökvägen till filen AzureStackStampInformation.json där skriptet kan hämta IP-adresserna för den virtuella ERCS-datorn.
CertificatePassword	Valfritt	Lösenord för certifikat som ska importeras till den virtuella datorn för Azure Stack Hub-åtkomst.
ERCSVMIP	Valfritt	IP för virtuella Azure Stack Hub ERCS-datorer som ska läggas till i listan över betrodda värdar för den virtuella datorn. Börjar inte gälla om -SkipNetworkConfiguration har angetts.
SkipNetworkConfiguration	Valfritt	Hoppar över nätverkskonfigurationen för den virtuella datorn så att användaren kan konfigurera senare.
DeploymentDataFilePath	Valfritt	Sökväg till DeploymentData.json. Börjar inte gälla om -SkipNetworkConfiguration har angetts.
PhysicalAdapterMACAddress	Valfritt	MAC-adressen för värdens nätverkskort som ska användas för att ansluta den virtuella datorn till. – Om det bara finns ett fysiskt nätverkskort behövs inte den här parametern och det enda nätverkskortet används. – Om det finns fler än ett fysiskt nätverkskort krävs den här parametern för att ange vilket som ska användas.
VirtualSwitchName	Valfritt	Namnet på den virtuella växel som måste konfigureras i Hyper-V för den virtuella datorn. – Om det finns VMSwitch med det angivna namnet väljs sådan VMSwitch. – Om det inte finns någon VMSwitch med det angivna namnet skapas en VMSwitch med det angivna namnet.
Re-Create	Valfritt	Tar bort och återskapar den virtuella datorn om det redan finns en virtuell dator med samma namn.

Kontrollera OAW VM-versionen

1. Logga in på den virtuella OAW-datorn med dina autentiseringsuppgifter.

2. Öppna PowerShell ISE och kör följande skript:

   C:\Version\Get-Version.ps1
   

   Exempel:

   

Överföra filer mellan HLH och OAW

Om du behöver överföra filer mellan HLH och OAW skapar du en SMB-resurs med hjälp av cmdleten New-SmbShare . New-SmbShare exponerar en filsystemmapp för fjärrklienter som en SMB-resurs (Server Message Block). Exempel:

Om du vill ta bort en resurs som skapades av den här cmdleten använder du cmdleten Remove-SmbShare .

Ta bort den virtuella OAW-datorn

Följande skript tar bort den virtuella OAW-datorn, som används för att komma åt Azure Stack Hub för administration och diagnostik. Det här skriptet tar också bort diskfilerna och skyddsfilen som är associerade med den virtuella datorn.

1. Logga in på HLH med dina autentiseringsuppgifter.

2. Öppna en upphöjd PowerShell-session.

3. Navigera till det extraherade innehållet i den installerade OAW.zip-filen.

4. Ta bort den virtuella datorn genom att köra skriptet Remove-OAW.ps1:

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

   Där <namnet> är namnet på den virtuella dator som ska tas bort. Som standard är namnet AzSOAW.

   Exempel:

   .\Remove-OAW.ps1 -VirtualMachineName AzSOAW
   

Nästa steg

Hanteringsuppgifter för Azure Stack