Skip to content

Enhance VPN client configuration instructions#128273

Open
nyanhp wants to merge 4 commits intoMicrosoftDocs:mainfrom
nyanhp:nyanhp-patch-1
Open

Enhance VPN client configuration instructions#128273
nyanhp wants to merge 4 commits intoMicrosoftDocs:mainfrom
nyanhp:nyanhp-patch-1

Conversation

@nyanhp
Copy link

@nyanhp nyanhp commented Mar 4, 2026

The existing instructions do not work for macOS, as the command azurevpn does not exist on macOS. The configuration can, however, be imported by storing it in the appropriate location. I've tested this both manually during development as well as with Intune.

@prmerger-automator
Copy link
Contributor

@nyanhp : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 22b1ee3:

✅ Validation status: passed

File Status Preview URL Details
includes/vpn-gateway-vwan-azure-vpn-client-optional.md ✅Succeeded

For more details, please refer to the build report.

@ttorble ttorble requested a review from Copilot March 4, 2026 15:43
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the VPN client profile import instructions to include macOS, where the azurevpn CLI command isn’t available, by documenting an alternate import mechanism.

Changes:

  • Split import guidance into OS-specific sections (Windows vs macOS).
  • Added a macOS shell-script example that copies the XML profile into the Azure VPN Client container location.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +45 to +47
consoleuser=$(ls -l /dev/console | awk '{ print $3 }')
filePath="/Users/$consoleuser/Library/Containers/com.microsoft.AzureVpnMac/Data/Library/Application Support/com.microsoft.AzureVpnMac/$profileName.AzureVpnProfile.xml"
cp $sourcePath $filePath
Copy link

Copilot AI Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Avoid parsing ls output to determine the console user. Prefer a more robust approach (for example using stat on /dev/console) to reduce the chance of unexpected formatting or locale differences breaking the command.

Suggested change
consoleuser=$(ls -l /dev/console | awk '{ print $3 }')
filePath="/Users/$consoleuser/Library/Containers/com.microsoft.AzureVpnMac/Data/Library/Application Support/com.microsoft.AzureVpnMac/$profileName.AzureVpnProfile.xml"
cp $sourcePath $filePath
consoleuser=$(stat -f '%Su' /dev/console)
filePath="/Users/$consoleuser/Library/Containers/com.microsoft.AzureVpnMac/Data/Library/Application Support/com.microsoft.AzureVpnMac/$profileName.AzureVpnProfile.xml"
cp "$sourcePath" "$filePath"

Copilot uses AI. Check for mistakes.
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This suggestion neither works on Linux nor on macOS.

@ttorble
Copy link
Contributor

ttorble commented Mar 4, 2026

@cherylmc

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Mar 4, 2026
nyanhp and others added 3 commits March 5, 2026 13:45
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit fd60233:

✅ Validation status: passed

File Status Preview URL Details
includes/vpn-gateway-vwan-azure-vpn-client-optional.md ✅Succeeded

For more details, please refer to the build report.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit f826f93:

✅ Validation status: passed

File Status Preview URL Details
includes/vpn-gateway-vwan-azure-vpn-client-optional.md ✅Succeeded

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants