Åtkomst arbets station för Azure Stack Hub-operatörAzure Stack Hub Operator Access Workstation

Operatörs åtkomst arbets stationen (OAW) används för att distribuera en hopp Box-dator (VM) på en maskinvarubaserad livs cykel värd (HLH) som kör version 2005 eller senare så att en Azure Stack hubb-operatör kan komma åt den privilegierade slut punkten (PEP) och administratörs portalen för support scenarier.The Operator Access Workstation (OAW) is used to deploy a jump box virtual machine (VM) on a Hardware Lifecycle Host (HLH) that runs version 2005 or later so an Azure Stack Hub operator can access the privileged endpoint (PEP) and the Administrator portal for support scenarios.

Den virtuella OAW-datorn ska skapas när en operatör utför en ny uppgift.The OAW VM should be created when an operator performs a new task. När en obligatorisk uppgift har slutförts i den virtuella datorn bör den virtuella datorn stängas av och tas bort eftersom Azure Stack Hub inte behöver köra den alltid.After a required task inside the VM is completed, the VM should be shut down and removed as Azure Stack Hub doesn't need to always run it.

OAW-scenarierOAW scenarios

I följande tabeller visas vanliga scenarier för OAW, men detta är inte exklusivt.The following tables lists common scenarios for the OAW, but this is not exclusive. Vi rekommenderar att du använder fjärr skrivbord för att ansluta till OAW.It is recommended to use Remote Desktop to connect to the OAW.

ScenarioScenario BeskrivningDescription
Få åtkomst till administrations portalenAccess the Administration portal Utföra administrativa åtgärderPerform administrative operations
Åtkomst PEPAccess PEP Insamling och uppladdning av loggar:Log collection and upload:
-Skapa en SMB-resurs på HLH för fil överföring från Azure Stack hubb-Create an SMB share on the HLH for file transfer from Azure Stack Hub
– Använd Azure Storage Explorer för att ladda upp loggar som sparats till SMB-resursen-Use Azure Storage Explorer to upload logs saved to the SMB share
Registrera Azure Stack hubbRegister Azure Stack Hub Hämta tidigare registrerings namn och resurs grupp från administrations portalen för omregistreringFor re-registration, get previous Registration Name and Resource Group from the Administration portal
Marketplace-syndikeringMarketplace syndication Skapa en SMB-resurs på HLH för att lagra den nedladdade avbildningen eller tilläggetCreate an SMB share on the HLH to store the downloaded image or extension

Ladda ned filerDownload files

Hämta filerna för att skapa den virtuella OAW-datorn genom att Ladda ned här.To get the files to create the OAW VM, download here. Se till att läsa igenom Microsofts sekretess policy och juridiska villkor innan du hämtar.Please be sure to review the Microsoft Privacy Statement and Legal Terms prior to download.

På grund av den tillstånds lösa lösningen för lösningen finns det inga uppdateringar för den virtuella OAW-datorn.Due to the stateless nature of the solution, there are no updates for the OAW VM. För varje mil stolpe frigörs en ny version av den virtuella dator avbildnings filen.For each milestone, a new version of the VM image file will be released. Använd den senaste versionen för att skapa en ny virtuell OAW-dator.Use the latest version to create a new OAW VM. Avbildnings filen baseras på den senaste versionen av Windows Server 2019.The image file is based on the latest Windows Server 2019 version. Efter installationen kan du tillämpa uppdateringar, inklusive eventuella kritiska uppdateringar, med hjälp av Windows Update.After installation, you can apply updates, including any critical updates, using Windows Update.

Verifiera hashen för den nedladdade OAW.zip filen för att kontrol lera att den inte har ändrats innan du använder den för att skapa den virtuella OAW-datorn.Validate the hash of the downloaded OAW.zip file to make sure it has not been modified before using it to create the OAW VM. Kör följande PowerShell-skript.Run the following PowerShell script. Om returvärdet är true kan du använda den nedladdade OAW.zip:If the return value is True, you can use the downloaded OAW.zip:

param(
    [Parameter(Mandatory=$True)]
    [ValidateNotNullOrEmpty()]
    [ValidateScript({Test-Path $_ -PathType Leaf})]
    [string]
    $DownloadedOAWZipFilePath
)

$expectedHash = '73E16995B79433E79F9EFA9A292443296D112B24B4D86A060FCB4C9403B8D014'
$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 is not safe to use it, please download it again.'
    Write-Error "Actual hash: $actualHash"
}

Princip för användar kontoUser account policy

Följande användar konto princip tillämpas på den virtuella datorn OAW:The following user account policy is applied to the OAW VM:

  • Användar namn för inbyggd administratör: AdminUserBuilt-in Administrator username: AdminUser
  • MinimumPasswordLength = 14MinimumPasswordLength = 14
  • PasswordComplexity har Aktiver ATSPasswordComplexity is enabled
  • MinimumPasswordAge = 1 (dag)MinimumPasswordAge = 1 (day)
  • MaximumPasswordAge = 42 (dagar)MaximumPasswordAge = 42 (days)
  • NewGuestName = GUser (inaktive rad som standard)NewGuestName = GUser (disabled by default)

Förinstallerad program varaPre-installed software

I följande tabell visas den förinstallerade program varan på den virtuella datorn OAW.The following table lists the pre-installed software on the OAW VM.

Program varu namnSoftware Name PlatsLocation
Microsoft Edge för företagMicrosoft Edge for Business [Systemdrive ] \Program-filer (x86) \Microsoft\Edge\Application[SystemDrive]\Program Files (x86)\Microsoft\Edge\Application
AZ-modulerAz Modules [Systemdrive- ] \ProgramFiles\WindowsPowerShell\Modules[SystemDrive]\ProgramFiles\WindowsPowerShell\Modules
PowerShell 7PowerShell 7 [Systemdrive ] \Program Files\PowerShell\7[SystemDrive]\Program Files\PowerShell\7
CLI (Azure Command-Line Interface)Azure Command-Line Interface (CLI) [Systemdrive ] \Program-filer (x86) \Microsoft SDKs\Azure\CLI2[SystemDrive]\Program Files (x86)\Microsoft SDKs\Azure\CLI2
Microsoft Azure Storage ExplorerMicrosoft Azure Storage Explorer [Systemdrive ] \Program-filer (x86) \microsoft Azure Storage Explorer[SystemDrive]\Program Files (x86)\Microsoft Azure Storage Explorer
AzCopyAzCopy [Systemdrive- ] \vmsoftware\ azcopy_windows_amd64_10.3.4[SystemDrive]\VMSoftware\azcopy_windows_amd64_10.3.4
AzureStack – verktygAzureStack-Tools [Systemdrive- ] \VMSoftware\AzureStack-tools[SystemDrive]\VMSoftware\AzureStack-Tools

Kontrol lera HLH-versionenCheck HLH version

  1. Logga in på HLH med dina autentiseringsuppgifter.Log onto the HLH with your credentials.

  2. Öppna PowerShell ISE och kör följande skript:Open PowerShell ISE and run the following script:

    'C:\Version\Get-Version.ps1'
    

    Till exempel:For example:

    Skärm bild av PowerShell-cmdlet för att kontrol lera versionen av den virtuella OAW-datorn

Skapa den virtuella OAW-datorn med ett skriptCreate the OAW VM using a script

Följande skript förbereder den virtuella datorn som operatörs åtkomst arbets Station (OAW), som används för att få åtkomst till Microsoft Azure Stack hubb för administration och diagnostik.The following script prepares the virtual machine as the Operator Access Workstation (OAW), which is used to access Microsoft Azure Stack Hub for administration and diagnostics.

  1. Logga in på HLH med dina autentiseringsuppgifter.Log onto the HLH with your credentials.
  2. Ladda ned OAW.zip och extrahera filerna.Download OAW.zip and extract the files.
  3. Öppna en upphöjd PowerShell-session.Open an elevated PowerShell session.
  4. Navigera till det extraherade innehållet i OAW.zips filen.Navigate to the extracted contents of the OAW.zip file.
  5. Kör New-OAW.ps1-skriptet.Run the New-OAW.ps1 script.

Om du till exempel vill skapa den virtuella datorn OAW på HLH utan någon anpassning med hjälp av Azure Stack Hub version 2005 eller senare kör du New-OAW.ps1 skriptet med endast parametern -LocalAdministratorPassword :For example, to create the OAW VM on the HLH without any customization using Azure Stack Hub version 2005 or later, run the New-OAW.ps1 script with only the -LocalAdministratorPassword parameter:

$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString
New-OAW.ps1 -LocalAdministratorPassword $securePassword  

Så här skapar du den virtuella OAW-datorn på en värd med nätverks anslutning till Azure Stack Hub:To create the OAW VM on a host with network connection to Azure Stack Hub:

$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString
New-OAW.ps1 -LocalAdministratorPassword $securePassword `
   -IPAddress '192.168.0.20' `
   -SubnetMask '255.255.255.0' `
   -DefaultGateway '192.168.0.1' `
   -DNS '192.168.0.10'

Hämta IP-adressen för den virtuella ERCS-datorn från AzureStackStampInformation.jspå filen:To retrieve the IP address of the ERCS VM from the AzureStackStampInformation.json file:

$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString
New-OAW.ps1 -LocalAdministratorPassword $securePassword `
   -AzureStackCertificatePath 'F:\certroot.cer' `
   -DeploymentDataFilePath 'F:\DeploymentData.json' `
   -AzSStampInfoFilePath 'F:\AzureStackStampInformation.json'

För att skapa den virtuella OAW-datorn på HLH med DeploymentData.jspå:To create the OAW VM on the HLH with DeploymentData.json:

$securePassword = Read-Host -Prompt "Enter password for Azure Stack OAW's local administrator" -AsSecureString
New-OAW.ps1 -LocalAdministratorPassword $securePassword `
   -DeploymentDataFilePath 'D:\AzureStack\DeploymentData.json'

Om DeploymentData.jsi filen innehåller namngivnings prefixet för OAW VM, används värdet för parametern VirtualMachineName .If the DeploymentData.json file includes the Naming Prefix for OAW VM, that value will be used for the VirtualMachineName parameter. Annars är standard namnet AzSOAW eller vilket namn som anges av användaren.Otherwise, the default name is AzSOAW or whatever name specified is by the user.

Två parameter uppsättningar är tillgängliga för New-OAW.Two parameter sets are available for New-OAW. Valfria parametrar visas inom hakparenteser.Optional parameters are shown in brackets.

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[]> `
[-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.The following table lists the definition for each parameter.

ParameterParameter Obligatorisk/valfriRequired/Optional BeskrivningDescription
LocalAdministratorPasswordLocalAdministratorPassword ObligatoriskRequired Lösen ordet för den virtuella datorns lokala administratörs konto AdminUser.Password for the virtual machine's local administrator account AdminUser.
IPAddressIPAddress ObligatoriskRequired Den statiska IPv4-adressen för att konfigurera TCP/IP på den virtuella datorn.The static IPv4 address to configure TCP/IP on the virtual machine.
NätmaskSubnetMask ObligatoriskRequired IPv4-nät masken för att konfigurera TCP/IP på den virtuella datorn.The IPv4 subnet mask to configure TCP/IP on the virtual machine.
GatewayDefaultGateway ObligatoriskRequired IPv4-adressen för standard-gatewayen för att konfigurera TCP/IP på den virtuella datorn.IPv4 address of the default gateway to configure TCP/IP on the virtual machine.
DNSDNS ObligatoriskRequired DNS-server (er) för att konfigurera TCP/IP på den virtuella datorn.DNS server(s) to configure TCP/IP on the virtual machine.
ImageFilePathImageFilePath ValfrittOptional Sökväg till OAW. vhdx som tillhandahålls av Microsoft.Path of OAW.vhdx provided by Microsoft. Standardvärdet är OAW. vhdx under samma överordnade mapp i det här skriptet.Default value is OAW.vhdx under the same parent folder of this script.
VirtualMachineNameVirtualMachineName ValfrittOptional Det namn som ska tilldelas den virtuella datorn.The name to be assigned to the virtual machine. Om det går att hitta ett namngivnings prefix i DeploymentData.jsfilen, används det som standard namn.If the Naming Prefix can be found in the DeploymentData.json file, it will be used as the default name. Annars kommer AzSOAW att användas som standard namn.Otherwise, AzSOAW will be used as the default name. Du kan ange ett annat namn för att skriva över standardvärdet.You can specify another name to overwrite the default value.
VirtualMachineMemoryVirtualMachineMemory ValfrittOptional Minne som ska tilldelas den virtuella datorn.Memory to be assigned to the virtual machine. Standardvärdet är 4 GB.Default value is 4GB.
VirtualProcessorCountVirtualProcessorCount ValfrittOptional Antal virtuella processorer som ska tilldelas den virtuella datorn.Number of virtual processors to be assigned to the virtual machine. Standardvärdet är 8.Default value is 8.
VirtualMachineDiffDiskPathVirtualMachineDiffDiskPath ValfrittOptional Sökväg för att lagra temporära diff-filer när den virtuella hanterings datorn var aktiv.Path to store temporary diff disk files while the management VM was active. Standardvärdet är DiffDisks under katalog under samma överordnade mapp i det här skriptet.Default value is DiffDisks subdirectory under the same parent folder of this script.
AzureStackCertificatePathAzureStackCertificatePath ValfrittOptional Sökvägen till certifikat som ska importeras till den virtuella datorn för Azure Stack hubb.Path of certificates to be imported to the virtual machine for Azure Stack Hub access.
AzSStampInfoFilePathAzSStampInfoFilePath ValfrittOptional Sökväg till AzureStackStampInformation.jspå filen där skriptet kan hämta IP-adresserna för den virtuella datorn ERCS.Path of AzureStackStampInformation.json file where the script can retrieve the IPs of the ERCS VM.
CertificatePasswordCertificatePassword ValfrittOptional Lösen ordet för det certifikat som ska importeras till den virtuella datorn för Azure Stack hubb.Password of certificate to be imported to the virtual machine for Azure Stack Hub access.
ERCSVMIPERCSVMIP ValfrittOptional IP för Azure Stack Hub ERCS-VM: ar som ska läggas till i den virtuella datorns betrodda värd lista.IP of Azure Stack Hub ERCS VM(s) to be added to trusted host list of the virtual machine. Börjar inte gälla om -SkipNetworkConfiguration har angetts.Won't take effect if -SkipNetworkConfiguration is set.
SkipNetworkConfigurationSkipNetworkConfiguration ValfrittOptional Hoppar över nätverks konfigurationen för den virtuella datorn så att användaren kan konfigurera senare.Skips network configuration for the virtual machine so user can configure later.
DeploymentDataFilePathDeploymentDataFilePath ValfrittOptional Sökväg till DeploymentData.jspå.Path of DeploymentData.json. Börjar inte gälla om -SkipNetworkConfiguration har angetts.Won't take effect if -SkipNetworkConfiguration is set.
PhysicalAdapterMACAddressPhysicalAdapterMACAddress ValfrittOptional MAC-adressen för värdens nätverkskort som ska användas för att ansluta den virtuella datorn till.The MAC address of the host's network adapter that will be used to connect the virtual machine to.
– Om det bara finns ett fysiskt nätverkskort behövs inte den här parametern och det enda nätverkskortet kommer att användas.- If there is only one physical network adapter, this parameter is not needed and the only network adapter will be used.
-Om det finns mer än ett fysiskt nätverkskort krävs den här parametern för att ange vilken som ska användas.- If there is more than one physical network adapter, this parameter is required to specify which one to use.
VirtualSwitchNameVirtualSwitchName ValfrittOptional Namnet på den virtuella växel som måste konfigureras i Hyper-V för den virtuella datorn.The name of virtual switch that needs to be configured in Hyper-V for the virtual machine.
– Om det finns VMSwitch med det angivna namnet väljs sådana VMSwitch.- If there is VMSwitch with the provided name, such VMSwitch will be selected.
– Om det inte finns någon VMSwitch med det angivna namnet skapas en VMSwitch med det angivna namnet.- If there is no VMSwitch with the provided name, a VMSwitch will be created with the provided name.
ÅterskapaReCreate ValfrittOptional Tar bort och återskapar den virtuella datorn om det redan finns en virtuell dator med samma namn.Removes and re-creates the virtual machine if there is already an existed virtual machine with the same name.

Kontrol lera den virtuella OAW-versionenCheck the OAW VM version

  1. Logga in på den virtuella datorn OAW med dina autentiseringsuppgifter.Log onto the OAW VM with your credentials.

  2. Öppna PowerShell ISE och kör följande skript:Open PowerShell ISE and run the following script:

    'C:\Version\Get-Version.ps1'
    

    Till exempel:For example:

    Skärm bild av PowerShell-cmdlet för att kontrol lera maskin varans livs cykels värd version

Överföra filer mellan HLH och OAWTransfer files between the HLH and OAW

Om du behöver överföra filer mellan HLH och OAW skapar du en SMB-resurs med hjälp av cmdleten New-SmbShare .If you need to transfer files between the HLH and the OAW, create an SMB share by using the New-SmbShare cmdlet. New-SmbShare exponerar en fil system katalog för fjärrklienter som en SMB-resurs (Server Message Block).New-SmbShare exposes a file system folder to remote clients as a Server Message Block (SMB) share. Till exempel:For example:

Om du vill ta bort en resurs som har skapats av denna cmdlet använder du cmdleten Remove-SmbShare .To delete a share that was created by this cmdlet, use the Remove-SmbShare cmdlet. Till exempel:For example:

Ta bort den virtuella OAW-datornRemove the OAW VM

Följande skript tar bort den virtuella OAW-datorn, som används för att komma åt Azure Stack hubb för administration och diagnostik.The following script removes the OAW VM, which is used to access Azure Stack Hub for administration and diagnostics. Det här skriptet tar också bort de diskpartitioner och skyddare som är associerade med den virtuella datorn.This script also removes the disk files and the guardian associated with the VM.

  1. Logga in på HLH med dina autentiseringsuppgifter.Log onto the HLH with your credentials.

  2. Öppna en upphöjd PowerShell-session.Open an elevated PowerShell session.

  3. Navigera till det extraherade innehållet i den installerade OAW.zips filen.Navigate to the extracted contents of the installed OAW.zip file.

  4. Ta bort den virtuella datorn genom att köra Remove-OAW.ps1 skriptet:Remove the VM by running the Remove-OAW.ps1 script:

    Remove-OAW.ps1 -VirtualMachineName <name>
    

    Där <name> är namnet på den virtuella dator som ska tas bort.Where <name> is the name of the virtual machine to be removed. Som standard är namnet AzSOAW.By default, the name is AzSOAW.

    Till exempel:For example:

    Remove-OAW.ps1 -VirtualMachineName AzSOAW
    

Nästa stegNext steps

Azure Stack hanterings uppgifterAzure Stack Management Tasks