Help migrating App Gateway v1 to v2

Uhmazing34 20 Reputation points
2023-10-20T12:02:16.55+00:00

Hello,

I am currently trying to migrate Application Gateway v1 to v2 according to this Microsoft documentation.
However, I am stuck on the following step:

"Run Get-Help AzureAppGWMigration.ps1 to examine the required parameters:"

When running it in PowerShell, it says:

Get-Help : Get-Help could not find AzureAppGWMigration.ps1 in a help file in this session. To download updated help topics type: "Update-Help". To get help online, search for the help topic in the TechNet library at https:/go.microsoft.com/fwlink/?LinkID=107116.
At line:1 char:1
+ Get-Help AzureAppGWMigration.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ResourceUnavailable: (:) [Get-Help], HelpNotFoundException
    + FullyQualifiedErrorId : HelpNotFound,Microsoft.PowerShell.Commands.GetHelpCommand

I already tried running the "Update-Help", but then I receive the following:

Update-Help : Failed to update Help for the module(s) 'ConfigDefender, ConfigDefenderPerformance, Dism, Get-NetView, Kds, NetQos, PcsvDevice, PKI, PSReadline, StorageBusCache, VMDirectStorage, Whea, WindowsUpdate' with UI culture(s) {en-US} : Unable to retrieve the HelpInfo XML file for UI culture en-US. Make sure the HelpInfoUri property in 
the module manifest is valid or check your network connection and then try the command again.
At line:1 char:1
+ Update-Help
+ ~~~~~~~~~~~
    + CategoryInfo          : ResourceUnavailable: (:) [Update-Help], Exception
    + FullyQualifiedErrorId : UnableToRetrieveHelpInfoXml,Microsoft.PowerShell.Commands.UpdateHelpCommand

Could anyone help me out on this?

Thank you in advance.

Azure Application Gateway
Azure Application Gateway
An Azure service that provides a platform-managed, scalable, and highly available application delivery controller as a service.
969 questions
{count} votes

1 answer

Sort by: Most helpful
  1. Andriy Bilous 10,996 Reputation points MVP
    2023-10-24T14:26:05.1133333+00:00

    Hello @Uhmazing34

    I understand that you are not able to update Update-Help.
    If you are using PowerShell 5.1, there is bug. The version of the PSReadline module that shipped in Windows PowerShell 5.1 used a lowercase letter in the name. The name of the module was changed for the release of PowerShell 6. It now uses a capital L in the name.

    The Update-Help cmdlet constructs the URL of the CAB file containing the updated help. The URL path is case-sensitive. The updated help files use the new name with the capital L. PowerShell 6 and higher is installed side-by-side with Windows PowerShell. When you run Update-Help, the cmdlet attempts to update the help for both versions of PowerShell. The name of the module that Update-Help uses is based on the name of the folder where the help is stored. For Windows PowerShell this is C:\Program Files\WindowsPowerShell\Modules\PSReadline.

    You can check parameters directly in the script
    https://www.powershellgallery.com/packages/AzureAppGWMigration/1.0.7/Content/AzureAppGWMigration.ps1

    To fix an Update-Help error try following solutions
    https://devblogs.microsoft.com/powershell/updating-help-for-the-psreadline-module-in-windows-powershell-5-1/
    https://stackoverflow.com/questions/52749398/powershell-update-help-fails

    0 comments No comments