Azure Stack hub-operator toegang tot werk stationAzure Stack Hub Operator Access Workstation

Het werk station van de operator toegang (OAW) wordt gebruikt voor het implementeren van een virtuele machine (Jump box) op een hardware Lifecycle host (HLH) waarop versie 2005 of hoger wordt uitgevoerd, zodat een Azure Stack hub-operator toegang kan krijgen tot de privileged endpoint (PEP) en de beheerders portal voor ondersteunings scenario's.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.

De OAW-VM moet worden gemaakt wanneer een operator een nieuwe taak uitvoert.The OAW VM should be created when an operator performs a new task. Nadat een vereiste taak in de virtuele machine is voltooid, moet de virtuele machine worden afgesloten en verwijderd omdat Azure Stack hub deze niet altijd hoeft uit te voeren.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-scenario'sOAW scenarios

De volgende tabellen geven een lijst van algemene scenario's voor de OAW, maar dit is niet exclusieve.The following tables lists common scenarios for the OAW, but this is not exclusive. Het is raadzaam om Extern bureaublad te gebruiken om verbinding te maken met de OAW.It is recommended to use Remote Desktop to connect to the OAW.

ScenarioScenario BeschrijvingDescription
Toegang tot de beheer PortalAccess the Administration portal Beheer bewerkingen uitvoerenPerform administrative operations
Toegang tot PEPAccess PEP Logboek verzameling en upload:Log collection and upload:
-Een SMB-share op de HLH maken voor bestands overdracht van Azure stack hub-Create an SMB share on the HLH for file transfer from Azure Stack Hub
-Azure Storage Explorer gebruiken voor het uploaden van logboeken die zijn opgeslagen op de SMB-share-Use Azure Storage Explorer to upload logs saved to the SMB share
Azure Stack hub registrerenRegister Azure Stack Hub Voor opnieuw registreren de vorige registratie naam en resource groep ophalen uit de beheer PortalFor re-registration, get previous Registration Name and Resource Group from the Administration portal
Marketplace-syndicatieMarketplace syndication Een SMB-share op de HLH maken om de gedownloade installatie kopie of extensie op te slaanCreate an SMB share on the HLH to store the downloaded image or extension

Bestanden downloadenDownload files

Down load hierom de bestanden op te halen voor het maken van de OAW-VM.To get the files to create the OAW VM, download here. Controleer de privacyverklaring van micro soft en juridische voor waarden voordat u de software downloadt.Please be sure to review the Microsoft Privacy Statement and Legal Terms prior to download.

Als gevolg van de stateless aard van de oplossing, zijn er geen updates voor de OAW-VM.Due to the stateless nature of the solution, there are no updates for the OAW VM. Voor elke mijl paal wordt een nieuwe versie van het VM-installatie kopie bestand vrijgegeven.For each milestone, a new version of the VM image file will be released. Gebruik de nieuwste versie om een nieuwe OAW-VM te maken.Use the latest version to create a new OAW VM. Het afbeeldings bestand is gebaseerd op de nieuwste versie van Windows Server 2019.The image file is based on the latest Windows Server 2019 version. Na de installatie kunt u updates, inclusief essentiële updates, Toep assen met behulp van Windows Update.After installation, you can apply updates, including any critical updates, using Windows Update.

Valideer de hash van het gedownloade OAW.zip bestand om er zeker van te zijn dat het niet is gewijzigd voordat u de OAW-VM maakt.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. Voer het volgende Power shell-script uit.Run the following PowerShell script. Als de geretourneerde waarde True is, kunt u de gedownloade OAW.zip gebruiken: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"
}

Beleid voor gebruikers accountsUser account policy

Het volgende beleid voor gebruikers accounts wordt toegepast op de OAW VM:The following user account policy is applied to the OAW VM:

  • Ingebouwde Administrator-gebruikers naam: AdminUserBuilt-in Administrator username: AdminUser
  • MinimumPasswordLength = 14MinimumPasswordLength = 14
  • PasswordComplexity is ingeschakeldPasswordComplexity is enabled
  • MinimumPasswordAge = 1 (dag)MinimumPasswordAge = 1 (day)
  • MaximumPasswordAge = 42 (dagen)MaximumPasswordAge = 42 (days)
  • NewGuestName = GUser (standaard uitgeschakeld)NewGuestName = GUser (disabled by default)

Vooraf geïnstalleerde softwarePre-installed software

De volgende tabel bevat de vooraf geïnstalleerde software op de OAW-VM.The following table lists the pre-installed software on the OAW VM.

Software naamSoftware Name LocatieLocation
Micro soft Edge voor bedrijvenMicrosoft Edge for Business [System Drive ] \Program Files (x86) \Microsoft\Edge\Application[SystemDrive]\Program Files (x86)\Microsoft\Edge\Application
AZ-modulesAz Modules [Systeem station ] \ProgramFiles\WindowsPowerShell\Modules[SystemDrive]\ProgramFiles\WindowsPowerShell\Modules
PowerShell 7PowerShell 7 [Systeem station ] \Program Files\PowerShell\7[SystemDrive]\Program Files\PowerShell\7
Azure Command-Line interface (CLI)Azure Command-Line Interface (CLI) [System Drive ] \Program Files (x86) \Microsoft SDKs\Azure\CLI2[SystemDrive]\Program Files (x86)\Microsoft SDKs\Azure\CLI2
Microsoft Azure Storage ExplorerMicrosoft Azure Storage Explorer [System Drive ] \Program Files (x86) \microsoft Azure Storage Explorer[SystemDrive]\Program Files (x86)\Microsoft Azure Storage Explorer
AzCopyAzCopy [Systeem station ] \vmsoftware\ azcopy_windows_amd64_10.3.4[SystemDrive]\VMSoftware\azcopy_windows_amd64_10.3.4
AzureStack-Hulpprogram Ma'sAzureStack-Tools [Systeem station ] \VMSoftware\AzureStack-tools[SystemDrive]\VMSoftware\AzureStack-Tools

Controleer de HLH-versieCheck HLH version

  1. Meld u aan bij de HLH met uw referenties.Log onto the HLH with your credentials.

  2. Open Power shell ISE en voer het volgende script uit:Open PowerShell ISE and run the following script:

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

    Bijvoorbeeld:For example:

    Scherm opname van de Power shell-cmdlet voor het controleren van de versie van de OAW-VM

De OAW-VM maken met behulp van een scriptCreate the OAW VM using a script

Met het volgende script wordt de virtuele machine voor bereid als de operator Access werk station (OAW), die wordt gebruikt voor toegang tot Microsoft Azure Stack hub voor beheer en diagnose.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. Meld u aan bij de HLH met uw referenties.Log onto the HLH with your credentials.
  2. Down load OAW.zip en pak de bestanden uit.Download OAW.zip and extract the files.
  3. Open een Power shell-sessie met verhoogde bevoegdheden.Open an elevated PowerShell session.
  4. Navigeer naar de uitgepakte inhoud van het OAW.zip bestand.Navigate to the extracted contents of the OAW.zip file.
  5. Voer het New-OAW.ps1 script uit.Run the New-OAW.ps1 script.

Als u bijvoorbeeld de OAW-VM op de HLH wilt maken zonder aanpassingen met Azure Stack hub versie 2005 of hoger, voert u het New-OAW.ps1 script uit met alleen de para meter -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  

De OAW-VM maken op een host met een netwerk verbinding naar 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'

Het IP-adres van de ERCS-VM ophalen uit de AzureStackStampInformation.jsin het bestand: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'

De OAW-VM maken op de HLH met DeploymentData.jsop: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'

Als de DeploymentData.jsin het bestand het naamgevings voorvoegsel bevat voor OAW VM, wordt die waarde gebruikt voor de para meter VirtualMachineName .If the DeploymentData.json file includes the Naming Prefix for OAW VM, that value will be used for the VirtualMachineName parameter. Anders is de standaard naam AzSOAW of welke naam is opgegeven door de gebruiker.Otherwise, the default name is AzSOAW or whatever name specified is by the user.

Er zijn twee parameter sets beschikbaar voor New-OAW.Two parameter sets are available for New-OAW. Optionele para meters worden tussen haakjes weer gegeven.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>]

De volgende tabel bevat de definitie voor elke para meter.The following table lists the definition for each parameter.

ParameterParameter Vereist/optioneelRequired/Optional BeschrijvingDescription
LocalAdministratorPasswordLocalAdministratorPassword VereistRequired Wacht woord voor de lokale Administrator-account van de virtuele machine AdminUser.Password for the virtual machine's local administrator account AdminUser.
IPAddressIPAddress VereistRequired Het statische IPv4-adres voor het configureren van TCP/IP op de virtuele machine.The static IPv4 address to configure TCP/IP on the virtual machine.
SubnetMaskSubnetMask VereistRequired Het IPv4-subnetmasker voor het configureren van TCP/IP op de virtuele machine.The IPv4 subnet mask to configure TCP/IP on the virtual machine.
DefaultGatewayDefaultGateway VereistRequired Het IPv4-adres van de standaard gateway voor het configureren van TCP/IP op de virtuele machine.IPv4 address of the default gateway to configure TCP/IP on the virtual machine.
DNSDNS VereistRequired DNS-server (s) voor het configureren van TCP/IP op de virtuele machine.DNS server(s) to configure TCP/IP on the virtual machine.
ImageFilePathImageFilePath OptioneelOptional Pad van OAW. vhdx van micro soft.Path of OAW.vhdx provided by Microsoft. De standaard waarde is OAW. vhdx onder dezelfde bovenliggende map van dit script.Default value is OAW.vhdx under the same parent folder of this script.
VirtualMachineNameVirtualMachineName OptioneelOptional De naam die moet worden toegewezen aan de virtuele machine.The name to be assigned to the virtual machine. Als het naam voorvoegsel kan worden gevonden in de DeploymentData.jsin het bestand, wordt dit als de standaard naam gebruikt.If the Naming Prefix can be found in the DeploymentData.json file, it will be used as the default name. Anders wordt AzSOAW gebruikt als de standaard naam.Otherwise, AzSOAW will be used as the default name. U kunt een andere naam opgeven om de standaard waarde te overschrijven.You can specify another name to overwrite the default value.
VirtualMachineMemoryVirtualMachineMemory OptioneelOptional Geheugen dat aan de virtuele machine moet worden toegewezen.Memory to be assigned to the virtual machine. De standaard waarde is 4 GB.Default value is 4GB.
VirtualProcessorCountVirtualProcessorCount OptioneelOptional Het aantal virtuele processors dat moet worden toegewezen aan de virtuele machine.Number of virtual processors to be assigned to the virtual machine. De standaard waarde is 8.Default value is 8.
VirtualMachineDiffDiskPathVirtualMachineDiffDiskPath OptioneelOptional Pad voor het opslaan van tijdelijke diff-schijf bestanden terwijl de virtuele machine van het beheer actief was.Path to store temporary diff disk files while the management VM was active. De standaard waarde is DiffDisks submap onder dezelfde bovenliggende map van dit script.Default value is DiffDisks subdirectory under the same parent folder of this script.
AzureStackCertificatePathAzureStackCertificatePath OptioneelOptional Het pad van de certificaten die moeten worden geïmporteerd naar de virtuele machine voor toegang tot Azure Stack hub.Path of certificates to be imported to the virtual machine for Azure Stack Hub access.
AzSStampInfoFilePathAzSStampInfoFilePath OptioneelOptional Het pad van AzureStackStampInformation.jsnaar het bestand waarin het script de IP-adressen van de ERCS VM kan ophalen.Path of AzureStackStampInformation.json file where the script can retrieve the IPs of the ERCS VM.
CertificatePasswordCertificatePassword OptioneelOptional Het wacht woord van het certificaat dat moet worden geïmporteerd naar de virtuele machine voor toegang tot Azure Stack hub.Password of certificate to be imported to the virtual machine for Azure Stack Hub access.
ERCSVMIPERCSVMIP OptioneelOptional IP-adres van Azure Stack hub-ERCS-VM ('s) die moeten worden toegevoegd aan de lijst met vertrouwde hosts van de virtuele machine.IP of Azure Stack Hub ERCS VM(s) to be added to trusted host list of the virtual machine. Treedt niet in werking als -SkipNetworkConfiguration is ingesteld.Won't take effect if -SkipNetworkConfiguration is set.
SkipNetworkConfigurationSkipNetworkConfiguration OptioneelOptional Hiermee slaat u de netwerk configuratie voor de virtuele machine over, zodat de gebruiker deze later kan configureren.Skips network configuration for the virtual machine so user can configure later.
DeploymentDataFilePathDeploymentDataFilePath OptioneelOptional Pad van DeploymentData.jsop.Path of DeploymentData.json. Treedt niet in werking als -SkipNetworkConfiguration is ingesteld.Won't take effect if -SkipNetworkConfiguration is set.
PhysicalAdapterMACAddressPhysicalAdapterMACAddress OptioneelOptional Het MAC-adres van de netwerk adapter van de host die wordt gebruikt om de virtuele machine te verbinden met.The MAC address of the host's network adapter that will be used to connect the virtual machine to.
-Als er slechts één fysieke netwerk adapter is, is deze para meter niet nodig en wordt de enige netwerk adapter gebruikt.- If there is only one physical network adapter, this parameter is not needed and the only network adapter will be used.
-Als er meer dan één fysieke netwerk adapter is, is deze para meter vereist om op te geven welke moet worden gebruikt.- If there is more than one physical network adapter, this parameter is required to specify which one to use.
VirtualSwitchNameVirtualSwitchName OptioneelOptional De naam van de virtuele switch die in Hyper-V moet worden geconfigureerd voor de virtuele machine.The name of virtual switch that needs to be configured in Hyper-V for the virtual machine.
-Als er een VMSwitch met de opgegeven naam is, wordt deze VMSwitch geselecteerd.- If there is VMSwitch with the provided name, such VMSwitch will be selected.
-Als er geen VMSwitch met de gegeven naam is, wordt er een VMSwitch gemaakt met de naam die u opgeeft.- If there is no VMSwitch with the provided name, a VMSwitch will be created with the provided name.
Opnieuw makenReCreate OptioneelOptional Hiermee wordt de virtuele machine verwijderd en opnieuw gemaakt als er al een bestaande virtuele machine met dezelfde naam bestaat.Removes and re-creates the virtual machine if there is already an existed virtual machine with the same name.

Controleer de versie van de OAW-VMCheck the OAW VM version

  1. Meld u aan bij de OAW-VM met uw referenties.Log onto the OAW VM with your credentials.

  2. Open Power shell ISE en voer het volgende script uit:Open PowerShell ISE and run the following script:

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

    Bijvoorbeeld:For example:

    Scherm opname van de Power shell-cmdlet voor het controleren van de versie van de levens cyclus van hardware

Bestanden tussen de HLH en OAW overdragenTransfer files between the HLH and OAW

Als u bestanden tussen de HLH en de OAW wilt overdragen, maakt u een SMB-share met behulp van de cmdlet 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 stelt een bestandsmap op externe clients in als een SMB-share (Server Message Block).New-SmbShare exposes a file system folder to remote clients as a Server Message Block (SMB) share. Bijvoorbeeld:For example:

Als u een share wilt verwijderen die door deze cmdlet is gemaakt, gebruikt u de cmdlet Remove-SmbShare .To delete a share that was created by this cmdlet, use the Remove-SmbShare cmdlet. Bijvoorbeeld:For example:

De OAW-VM verwijderenRemove the OAW VM

Met het volgende script wordt de OAW-VM verwijderd, die wordt gebruikt voor toegang tot Azure Stack hub voor beheer en diagnose.The following script removes the OAW VM, which is used to access Azure Stack Hub for administration and diagnostics. Met dit script worden ook de schijf bestanden en de Guardian verwijderd die aan de VM zijn gekoppeld.This script also removes the disk files and the guardian associated with the VM.

  1. Meld u aan bij de HLH met uw referenties.Log onto the HLH with your credentials.

  2. Open een Power shell-sessie met verhoogde bevoegdheden.Open an elevated PowerShell session.

  3. Navigeer naar de uitgepakte inhoud van het geïnstalleerde OAW.zip-bestand.Navigate to the extracted contents of the installed OAW.zip file.

  4. Verwijder de virtuele machine door het Remove-OAW.ps1 script uit te voeren:Remove the VM by running the Remove-OAW.ps1 script:

    Remove-OAW.ps1 -VirtualMachineName <name>
    

    Waar <name> de naam is van de virtuele machine die moet worden verwijderd.Where <name> is the name of the virtual machine to be removed. Standaard is de naam AzSOAW.By default, the name is AzSOAW.

    Bijvoorbeeld:For example:

    Remove-OAW.ps1 -VirtualMachineName AzSOAW
    

Volgende stappenNext steps

Azure Stack beheer takenAzure Stack Management Tasks