search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.3k stars 21.48k forks source link

Azure Arc Powershell Version Difference for 2012R2 in documentation/onboarding gpo #106201

Closed barneynoble closed 1 year ago

barneynoble commented 1 year ago

Hello, Whilst running AzureArc onboarding through the GPO for server 2012R2 releases, the documentation here (https://learn.microsoft.com/en-us/azure/azure-arc/servers/prerequisites#software-requirements) says "Powershell version 4.0", however in the EnableAzureArc.ps1 utility (accessible via (https://github.com/Azure/ArcEnabledServersGroupPolicy/releases/tag/1.0.2)) theres a check enforced on lines 475-481 (shown below) to check if powershell version 5.1 is installed. If 5.1 is not installed, this fails the installation.

if (($ArcOnboardingData.AzureVM -eq $false) -and ($ArcOnboardingData.ArcCompatible -eq $false)) { Write-Log -msg "Machine doesn't meet the minimun requirements for Azure Arc: Windows PowerShell 5.1 and NET Framework 4.6, or it is an Azure VM." -msgtype ERROR Send-ArcData -Data $ArcOnboardingData -Path "$LoggingNetworkPath\$($env:COMPUTERNAME).xml" Write-Log -msg "End of the Azure Arc Onboarding process..." -msgtype INFO

exit

}

Should the documentation be updated to reflect powershell version 5.1 as the required version or is powershell version 4.0 correct and the check on this utility incorrect?

I've tested manually installing/registering azure arc and this works successfully, but i'm not sure for the methodology behind this?

Thanks

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

RamanathanChinnappan-MSFT commented 1 year ago

@barneynoble

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

KrishnaG-MSFT commented 1 year ago

@barneynoble Thanks for surfacing this, we’ll be working to resolve this in the Group Policy onboarding script. Appreciate it!

please-close

KrishnaG-MSFT commented 1 year ago

@barneynoble Product group has updated the package to reflect the documentation. Powershell 4 is now the minimum. The link from the portal is dynamic and should be updated. You can also find it here https://github.com/Azure/ArcEnabledServersGroupPolicy/releases/latest

image
barneynoble commented 1 year ago

Thanks for resolving this Krishna - appreciate the speedy responses.

Cheers, Barney