Skip to content

Conversation

@bebound
Copy link
Contributor

@bebound bebound commented Dec 11, 2023

Doc for zip package: Azure/azure-cli#27911

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 4783fd7:

⚠️ Validation status: warnings

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md ⚠️Warning View Details

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 125, Column 46: [Warning: file-not-found - See documentation] Invalid file link: '../release-notes-azure-cli.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 71ddfad:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit c951450:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 6e27b0a:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 5de3098:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:


If you want to run the `az` command directly, then follow the steps below to add the Azure CLI to your PATH environment variable.
1. Open the Start Menu and search for `environment variables`, click `Edit the system environment variables`.
2. Click `Environment Variables...` button.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

You can also use settings -> system -> about ->Advanced system settings to open this dialog, although it requires more steps.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 42dd90a:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2e2552d:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@bebound bebound marked this pull request as ready for review January 11, 2024 06:44
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 14ad7de:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 8e2a694:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 0c730e6:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit d401de5:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 6a7de88:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@bebound
Copy link
Contributor Author

bebound commented Jan 29, 2024

@dbradish-microsoft Could you please review this? We need to merge it in the upcoming release. Thank you.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit ab4479f:

💡 Validation status: suggestions

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md 💡Suggestion View Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 115, Column 3: [Suggestion: other-site-link-broken - See documentation] Link 'https://aka.ms/installazurecliwindowszipx64' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Co-authored-by: Delora Bradish <dbradish@microsoft.com>
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 6d49d04:

💡 Validation status: suggestions

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md 💡Suggestion View Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 115, Column 3: [Suggestion: other-site-link-broken - See documentation] Link 'https://aka.ms/installazurecliwindowszipx64' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 82fba7d:

💡 Validation status: suggestions

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md 💡Suggestion View Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 115, Column 3: [Suggestion: other-site-link-broken - See documentation] Link 'https://aka.ms/installazurecliwindowszipx64' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2fd82e7:

💡 Validation status: suggestions

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md 💡Suggestion View Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 118, Column 3: [Suggestion: other-site-link-broken - See documentation] Link 'https://aka.ms/installazurecliwindowszipx64' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 81c2e31:

💡 Validation status: suggestions

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md 💡Suggestion View Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View

docs-ref-conceptual/install-azure-cli-windows.md

  • Line 118, Column 3: [Suggestion: other-site-link-broken - See documentation] Link 'https://aka.ms/installazurecliwindowszipx64' points to a page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Co-authored-by: Delora Bradish <dbradish@microsoft.com>
Co-authored-by: Delora Bradish <dbradish@microsoft.com>
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit ba5edfc:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

### Latest version

> [!div class="nextstepaction"]
> [Latest release of the Azure CLI (64-bit)](https://aka.ms/installazurecliwindowszipx64)
Copy link
Member

Choose a reason for hiding this comment

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

The button title will be the same as MSI:

image

How about using

  • Latest MSI of the Azure CLI (32-bit)
  • Latest MSI of the Azure CLI (64-bit)
  • Latest ZIP of the Azure CLI (64-bit)

```

This command also updates all installed extensions by default. For more `az upgrade` options, see the [command reference page](/cli/azure/reference-index#az_upgrade). For Azure CLI versions prior to [2.11.0](/cli/azure/release-notes-azure-cli#august-25-2020), update by reinstalling as described in [Install the Azure CLI](../install-azure-cli.md).
This command also updates all installed extensions by default. For more `az upgrade` options, see the [command reference page](/cli/azure/reference-index#az_upgrade). For Azure CLI versions prior to [2.11.0](/cli/azure/release-notes-azure-cli#august-25-2020), update by reinstalling as described in [Install the Azure CLI](../install-azure-cli.md).
Copy link
Member

Choose a reason for hiding this comment

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

What is changed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Newline at the end of file is removed accidentally. 😂

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit bb80b73:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

bebound and others added 2 commits February 6, 2024 15:06
Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
You can use the ZIP package to install the Azure CLI on Windows. This package is useful when you don't have administrative privilege.

Unzip the package to a folder, then using Cmd or PowerShell, call the Azure CLI by running `<unzipped folder path>\bin\az.cmd`.
Copy link
Member

Choose a reason for hiding this comment

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

Same as #4045 (comment), I suggest we do mention how to call it if the path contains space - in both CMD and PowerShell.

Copy link
Contributor Author

@bebound bebound Feb 6, 2024

Choose a reason for hiding this comment

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

The space doc is removed for two reasons:

  1. In general, the simplest way to call az is adding it into PATH.
  2. If the user chooses to use the full path with spaces, they must know how to correctly do so in Windows. (After all, this problem is not introduced by az.)

(The command to call path with spaces is not unified in CMD and PS. I want to keep our doc concise. If many users report this issue in the future, we may add it then.)

Copy link
Collaborator

Choose a reason for hiding this comment

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

I agree with @jiasli. I don't feel it is possible to have too much clarity. Is is possible to have too many words! :-)

Our install docs receive the most negative feedback of any doc group in our repo, so I prefer not to wait for a customer complaint.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 5285214:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/az-upgrade.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 9f85da2:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 26c9d6d:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View

For more details, please refer to the build report.

For any questions, please:

@dbradish-microsoft
Copy link
Collaborator

Merging this PR with @jiasli's approval and @bebound 's request to me via Teams. I will spin up a 2nd PR to continue the discussion on the conceptual tab for CMD and PowerShell. (See 4045 comment.)

@dbradish-microsoft dbradish-microsoft merged commit 6fdcc21 into MicrosoftDocs:main Feb 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants