The documentation regarding Azure PowerShell installation is outdated

OrlandoAMunoz commented 1 year ago

Prerequisites

[X] Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
[X] Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Typo in Get-Foo cmdlet" instead of "Typo."
[X] Verify Version: If there is a mismatch between documentation and the behavior on your system, ensure that the version you are using is the same as the documentation. Check this box if they match or the issue you are reporting is not version specific.

Links

https://learn.microsoft.com/en-us/powershell/azure/servicemanagement/install-azure-ps?view=azuresmps-4.0.0

Summary

The steps required to install and login to Azure using the Azure Powershell module are outdated, and do not take into account dependencies and the current need to enable TLS 1.2.

Details

TLS 1.2 must be enabled for the commands to interact correcty with the repositories and with the Azure infrastructure.

Repository NuGet must be installed on PowerShell 5.1 for the Azure module to be found and installed.

Suggested Fix

Correct steps, as validated during a case resolution:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Install-PackageProvider -Name NuGet Install-Module -Name Azure -AllowClobber Add-AzureAccount

RamanathanChinnappan-MSFT commented 1 year ago

@OrlandoAMunoz

Thanks for your feedback! We will investigate and update as appropriate.

I've delegated this to @mikefrobbins, a content author, to review and share their valuable insights.

OrlandoAMunoz commented 1 year ago

Hi Mike,

The #2593 was posted by mistake with my personal account. Please consider this one #2593 posted with my work @.***) account.

Otherwise it will not count for my performance review.

Kind regards,

Orlando Alvarez Muñoz Support Engineer Microsoft Azure Technical Support Customer Service and Support Office: +351 (21) 0491844 @.**@.> Working hours: 8:30-17:30 UTC+1 If you need to work with another Support Engineer outside of my working hours, please send email to @.**@.> with your case number, and availability. We are always interested to hear your feedback. Please feel free to reach my manager regarding the level of service you have received, at @.**@.> . [Microsoft Azure logo horizontal]

From: Mike F. Robbins @.> Sent: Tuesday, June 6, 2023 20:25 To: MicrosoftDocs/azure-docs-powershell @.> Cc: Orlando Muñoz @.>; Mention @.> Subject: Re: [MicrosoftDocs/azure-docs-powershell] The documentation regarding Azure PowerShell installation is outdated (Issue #2594)

@OrlandoAMunozhttps://github.com/OrlandoAMunoz Closing due to this being a duplicate issue. See #2593https://github.com/MicrosoftDocs/azure-docs-powershell/issues/2593 for tracking of this problem.

- Reply to this email directly, view it on GitHubhttps://github.com/MicrosoftDocs/azure-docs-powershell/issues/2594#issuecomment-1579326415, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AXZ7ICZBFJLJ46MAKA6OL5DXJ57Y7ANCNFSM6AAAAAAY4KQSAM. You are receiving this because you were mentioned.Message ID: @.**@.>>

mikefrobbins commented 1 year ago

@OrlandoAMunoz, The issue with enabling TLS 1.2 and installing NuGet on Windows PowerShell 5.1 is due to the PowerShellGet module requiring an update. I've added a link to Update PowerShellGet for Windows PowerShell 5.1 in the prerequisites section to resolve this issue (see PR #2593).

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser <<- Already part of the prerequisites section [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 <<- Covered by updating PowerShellGet Install-PackageProvider -Name NuGet <<- Covered by updating PowerShellGet Install-Module -Name Azure -AllowClobber <<- Already part of the installation section Add-AzureAccount <<- Already part of the sign in section

OrlandoAMunoz commented 1 year ago

Hi Mike,

Thank you for the feedback 😊

Kind regards,

Orlando Alvarez Muñoz Support Engineer Microsoft Azure Technical Support Customer Service and Support Office: +351 (21) 0491844 @.**@.> Working hours: 8:30-17:30 UTC+1 If you need to work with another Support Engineer outside of my working hours, please send email to @.**@.> with your case number, and availability. We are always interested to hear your feedback. Please feel free to reach my manager regarding the level of service you have received, at @.**@.> . [Microsoft Azure logo horizontal]

From: Mike F. Robbins @.> Sent: Monday, June 12, 2023 18:22 To: MicrosoftDocs/azure-docs-powershell @.> Cc: Orlando Muñoz @.>; Mention @.> Subject: Re: [MicrosoftDocs/azure-docs-powershell] The documentation regarding Azure PowerShell installation is outdated (Issue #2594)

@OrlandoAMunozhttps://github.com/OrlandoAMunoz, The issue with enabling TLS 1.2 and installing NuGet on Windows PowerShell 5.1 is due to the PowerShellGet module requiring an update. I've added a link to Update PowerShellGet for Windows PowerShell 5.1https://learn.microsoft.com/powershell/gallery/powershellget/update-powershell-51 in the prerequisites section to resolve this issue (see PR #2593https://github.com/MicrosoftDocs/azure-docs-powershell/issues/2593).

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser <<- Already part of the prerequisites section [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 <<- Covered by updating PowerShellGet Install-PackageProvider -Name NuGet <<- Covered by updating PowerShellGet Install-Module -Name Azure -AllowClobber <<- Already part of the installation section Add-AzureAccount <<- Already part of the sign in section

— Reply to this email directly, view it on GitHubhttps://github.com/MicrosoftDocs/azure-docs-powershell/issues/2594#issuecomment-1587749831, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AXZ7ICZPQUKRHKTWVUHYURDXK5F2RANCNFSM6AAAAAAY4KQSAM. You are receiving this because you were mentioned.Message ID: @.**@.>>

MicrosoftDocs / azure-docs-powershell