Merge pull request #263838 from sdwheeler/sdw-newux

Reorg and add new UX docs

Author: v-regandowner

articles/cloud-shell/.openpublishing.redirection.cloud-shell.json

@@ -1,68 +1,88 @@
 {
     "redirections": [
         {
-            "source_path_from_root": "/articles/cloud-shell/troubleshooting.md",
-            "redirect_url": "/azure/cloud-shell/faq-troubleshooting",
-            "redirect_document_id": true
+            "redirect_url": "/azure/cloud-shell/overview",
+            "source_path_from_root": "/articles/cloud-shell/index.md",
+            "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/limitations.md",
             "redirect_url": "/azure/cloud-shell/faq-troubleshooting",
+            "source_path_from_root": "/articles/cloud-shell/limitations.md",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/private-vnet.md",
-            "redirect_url": "/azure/cloud-shell/vnet-overview",
+            "redirect_url": "/azure/cloud-shell/faq-troubleshooting",
+            "source_path_from_root": "/articles/cloud-shell/troubleshooting.md",
             "redirect_document_id": true
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/quickstart-deploy-vnet.md",
-            "redirect_url": "/azure/cloud-shell/vnet-deployment",
-            "redirect_document_id": true
+            "redirect_url": "/azure/cloud-shell/features",
+            "source_path_from_root": "/articles/cloud-shell/features-powershell.md",
+            "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/msi-authorization.md",
-            "redirect_url": "/azure/active-directory/managed-identities-azure-resources/managed-identities-status",
-            "redirect_document_id": true
+            "redirect_url": "/azure/cloud-shell/get-started/classic",
+            "source_path_from_root": "/articles/cloud-shell/cloud-shell-windows-users.md",
+            "redirect_document_id": false
         },
         {
+            "redirect_url": "/azure/cloud-shell/get-started/classic",
             "source_path_from_root": "/articles/cloud-shell/quickstart.md",
-            "redirect_url": "/azure/cloud-shell/get-started",
-            "redirect_document_id": true
+            "redirect_document_id": false
         },
         {
+            "redirect_url": "/azure/cloud-shell/get-started/classic",
             "source_path_from_root": "/articles/cloud-shell/quickstart-powershell.md",
-            "redirect_url": "/azure/cloud-shell/get-started",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/cloud-shell-windows-users.md",
-            "redirect_url": "/azure/cloud-shell/get-started",
-            "redirect_document_id": false
+            "redirect_url": "/azure/cloud-shell/get-started/classic",
+            "source_path_from_root": "/articles/cloud-shell/get-started.md",
+            "redirect_document_id": true
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/features-powershell.md",
-            "redirect_url": "/azure/cloud-shell/features",
+            "redirect_url": "/azure/cloud-shell/persisting-shell-storage",
+            "source_path_from_root": "/articles/cloud-shell/persisting-shell-storage-powershell.md",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/persisting-shell-storage-powershell.md",
-            "redirect_url": "/azure/cloud-shell/persisting-shell-storage",
+            "redirect_url": "/azure/cloud-shell/vnet/deployment",
+            "source_path_from_root": "/articles/cloud-shell/quickstart-deploy-vnet.md",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/example-terraform-bash.md",
-            "redirect_url": "/azure/developer/terraform/quickstart-configure",
+            "redirect_url": "/azure/cloud-shell/vnet/deployment",
+            "source_path_from_root": "/articles/cloud-shell/vnet-deployment.md",
+            "redirect_document_id": true
+        },
+        {
+            "redirect_url": "/azure/cloud-shell/vnet/overview",
+            "source_path_from_root": "/articles/cloud-shell/private-vnet.md",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/security-baseline.md",
-            "redirect_url": "/security/benchmark/azure/baselines/cloud-shell-security-baseline",
+            "redirect_url": "/azure/cloud-shell/vnet/overview",
+            "source_path_from_root": "/articles/cloud-shell/vnet-overview.md",
+            "redirect_document_id": true
+        },
+        {
+            "redirect_url": "/azure/cloud-shell/vnet/troubleshooting",
+            "source_path_from_root": "/articles/cloud-shell/vnet-troubleshooting.md",
+            "redirect_document_id": true
+        },
+        {
+            "redirect_url": "/azure/active-directory/managed-identities-azure-resources/managed-identities-status",
+            "source_path_from_root": "/articles/cloud-shell/msi-authorization.md",
+            "redirect_document_id": true
+        },
+       {
+            "redirect_url": "/azure/developer/terraform/quickstart-configure",
+            "source_path_from_root": "/articles/cloud-shell/example-terraform-bash.md",
             "redirect_document_id": false
         },
         {
-            "source_path_from_root": "/articles/cloud-shell/index.md",
-            "redirect_url": "/azure/cloud-shell/overview",
+            "redirect_url": "/security/benchmark/azure/baselines/cloud-shell-security-baseline",
+            "source_path_from_root": "/articles/cloud-shell/security-baseline.md",
             "redirect_document_id": false
         }
     ]

articles/cloud-shell/TOC.yml

@@ -6,7 +6,15 @@ items:
       - name: Features & tools
         href: features.md
   - name: Get started with Cloud Shell
-    href: get-started.md
+    items:
+      - name: Get started (Classic)
+        href: get-started/classic.md
+      - name: Get started (New UI)
+        href: get-started/ephemeral.md
+      - name: Get started with new storage account (New UI)
+        href: get-started/new-storage.md
+      - name: Get started with existing storage account (New UI)
+        href: get-started/existing-storage.md
   - name: How to use Cloud Shell
     items:
       - name: Persist files in storage
@@ -24,11 +32,11 @@ items:
   - name: Deploy Cloud Shell in a virtual network
     items:
       - name: Overview
-        href: vnet-overview.md
+        href: vnet/overview.md
       - name: Deploy using quickstart templates
-        href: vnet-deployment.md
+        href: vnet/deployment.md
       - name: Troubleshoot Azure Cloud Shell in a virtual network
-        href: vnet-troubleshooting.md
+        href: vnet/troubleshooting.md
   - name: Pricing
     items:
       - name: Cloud Shell pricing

articles/cloud-shell/cloud-shell-predictive-intellisense.md

@@ -7,9 +7,9 @@ title: Predictive IntelliSense in Azure Cloud Shell
 
 # Predictive IntelliSense in Azure Cloud Shell
 
-Beginning January 2023 Azure Cloud Shell uses the version of [PSReadLine][01] that has Predictive
+Beginning January 2023 Azure Cloud Shell uses the version of [PSReadLine][03] that has Predictive
 IntelliSense enabled by default. We've also installed and enabled the Azure PowerShell predictor
-[Az.Tools.Predictor][02]] module. Together, these changes enhance the command-line experience by
+[Az.Tools.Predictor][01] module. Together, these changes enhance the command-line experience by
 providing suggestions that help new and experienced users of Azure discover, edit, and execute
 complete commands.
 
@@ -24,11 +24,11 @@ the default `InlineView` of the suggestion. Pressing <kbd>RightArrow</kbd> key a
 suggestion. After accepting the suggestion, you can edit the command line before hitting
 <kbd>Enter</kbd> to run the command.
 
-![Suggestion in InlineView mode](./media/predictive-intellisense/cloud-shell-inline.png)
+![Suggestion in InlineView mode][06]
 
 PSReadLine also offers a `ListView` presentation of the suggestions.
 
-![Suggestions in ListView mode](./media/predictive-intellisense/cloud-shell-list-view.png)
+![Suggestions in ListView mode][07]
 
 In `ListView` mode, use the arrow keys to scroll through the available suggestions. List view also
 shows the source of the prediction.
@@ -43,10 +43,12 @@ configure the color of the suggestions.
 The following command changes the color of inline suggestions to white text on a gray background.
 
 ```powershell
-Set-PSReadLineOption -Colors @{ InlinePrediction = $PSStyle.Foreground.White + $PSStyle.Background.BrightBlack }
+Set-PSReadLineOption -Colors @{
+    InlinePrediction = $PSStyle.Foreground.White + $PSStyle.Background.BrightBlack
+}
 ```
 
-Learn more about color settings for [Set-PSReadLineOption][03].
+Learn more about color settings for [Set-PSReadLineOption][04].
 
 ## How to disable Predictive IntelliSense
 
@@ -65,7 +67,7 @@ Set-PSReadLineOption -PredictionSource None
 The commands to change the prediction color and enable or disable predictions only affect the
 current session. Add these commands to your PowerShell profile so that they're available every time
 you start Cloud Shell. The following instructions will guide you through configuring a profile for
-Cloud Shell. For more information on PowerShell profiles, see [About_Profiles][06]
+Cloud Shell. For more information on PowerShell profiles, see [About_Profiles][02]
 
 ### How to check if you have a PowerShell profile in Cloud Shell
 
@@ -96,7 +98,8 @@ UnixMode   User             Group                 LastWriteTime           Size N
 -rw-r--r-- jason            jason              11/19/2022 18:21              0 Microsoft.PowerShell_profile.ps1
 ```
 
-Use the built-in open-source editor to edit the profile. To learn more, see [Azure Cloud Shell editor][04].
+Use the built-in open-source editor to edit the profile. To learn more, see
+[Azure Cloud Shell editor][08].
 
 The following example shows the profile commands that set the prediction color to default light grey
 and enables History predictions.
@@ -110,7 +113,7 @@ Set-PSReadLineOption -Colors @{ InLinePrediction = '#8d8d8d' }
 
 If the output is **True**, then a profile already exists. Edit the existing profile to add the
 commands to configure the color and behavior of Predictive IntelliSense. Use the built-in
-open-source editor to edit the profile. To learn more, see [Azure Cloud Shell editor][04].
+open-source editor to edit the profile. To learn more, see [Azure Cloud Shell editor][08].
 
 Use the built-in Cloud Shell editor to edit the profile:
 
@@ -123,13 +126,15 @@ code $Profile
 For more information about configuring PSReadLine and managing predictors, see
 [Using predictors in PSReadLine][05].
 
-For more information on PowerShell profiles, see [About_Profiles][06].
+For more information on PowerShell profiles, see [About_Profiles][02].
 
 
 <!-- link references -->
-[01]: /powershell/module/psreadline/about/about_psreadline
-[02]: /powershell/azure/az-predictor
-[03]: /powershell/module/psreadline/set-psreadlineoption
-[04]: ./using-cloud-shell-editor.md
+[01]: /powershell/azure/az-predictor
+[02]: /powershell/module/microsoft.powershell.core/about/about_profiles
+[03]: /powershell/module/psreadline/about/about_psreadline
+[04]: /powershell/module/psreadline/set-psreadlineoption
 [05]: /powershell/scripting/learn/shell/using-predictors
-[06]: /powershell/module/microsoft.powershell.core/about/about_profiles
+[06]: media/predictive-intellisense/cloud-shell-inline.png
+[07]: media/predictive-intellisense/cloud-shell-list-view.png
+[08]: using-cloud-shell-editor.md

articles/cloud-shell/get-started.md renamed to articles/cloud-shell/get-started/classic.md

@@ -1,7 +1,7 @@
 ---
 description: Learn how to start using Azure Cloud Shell.
 ms.contributor: jahelmic
-ms.date: 10/30/2023
+ms.date: 01/22/2024
 ms.topic: article
 tags: azure-resource-manager
 title: Get started with Azure Cloud Shell
@@ -135,12 +135,12 @@ Get-AzCommand
 - [Learn about Azure Files storage][01]
 
 <!-- link references -->
-[01]: ../storage/files/storage-files-introduction.md
+[01]: /azure/storage/files/storage-files-introduction
 [02]: /cli/azure/
 [03]: /powershell/azure/
 [04]: https://portal.azure.com/
-[05]: media/get-started/choose-shell.png
-[06]: media/get-started/create-storage.png
-[07]: media/get-started/resource-provider.png
-[08]: media/get-started/shell-icon.png
-[09]: persisting-shell-storage.md
+[05]: media/classic/choose-shell.png
+[06]: media/classic/create-storage.png
+[07]: media/classic/resource-provider.png
+[08]: media/classic/shell-icon.png
+[09]: ../persisting-shell-storage.md

articles/cloud-shell/get-started/ephemeral.md

@@ -0,0 +1,121 @@
+---
+description: Learn how to start using Azure Cloud Shell without a storage account.
+ms.contributor: jahelmic
+ms.date: 01/22/2024
+ms.topic: article
+tags: azure-resource-manager
+title: Get started with Azure Cloud Shell ephemeral sessions
+---
+# Get started with Azure Cloud Shell ephemeral sessions
+
+Using Cloud Shell ephemeral sessions is the fastest way to start using Cloud Shell. Ephemeral
+sessions don't require a storage account. When you close the Cloud Shell window, all files you saved
+are deleted and don't persist across sessions.
+
+## Start Cloud Shell
+
+1. Sign into the [Azure portal][04].
+1. Launch **Cloud Shell** from the top navigation of the Azure portal.
+
+   ![Screenshot showing how to start Azure Cloud Shell in the Azure portal.][07]
+
+1. The first time you start Cloud Shell you're prompted to which shell to use. Select **Bash** or
+   **PowerShell**.
+
+   ![Screenshot showing the prompt to select the shell.][05]
+
+1. In the **Getting started** pane, select **No storage account required** for an ephemeral session.
+   Using the dropdown menu, select the subscription you want to use for Cloud Shell, then select
+   the **Apply** button.
+
+   ![Screenshot showing the select subscription and optional storage prompt.][06]
+
+### Set your subscription
+
+1. List subscriptions you have access to.
+
+   <!-- markdownlint-disable MD023 MD024 MD051-->
+   #### [Azure CLI](#tab/azurecli)
+
+   ```azurecli-interactive
+   az account list
+   ```
+
+   #### [Azure PowerShell](#tab/powershell)
+
+   ```azurepowershell-interactive
+   Get-AzSubscription
+   ```
+
+1. Set your preferred subscription:
+
+   #### [Azure CLI](#tab/azurecli)
+
+   ```azurecli-interactive
+   az account set --subscription 'my-subscription-name'
+   ```
+
+   #### [Azure PowerShell](#tab/powershell)
+
+   ```azurepowershell-interactive
+   Set-AzContext -Subscription <SubscriptionId>
+   ```
+   <!-- markdownlint-enable MD023 MD024 MD051-->
+   ---
+
+> [!TIP]
+> Your subscription is remembered for future sessions using `/home/<user>/.azure/azureProfile.json`.
+
+### Get a list of Azure commands
+
+<!-- markdownlint-disable MD023 MD024 MD051-->
+#### [Azure CLI](#tab/azurecli)
+
+Run the following command to see a list of all Azure CLI commands.
+
+```azurecli-interactive
+az
+```
+
+Run the following command to get a list of Azure CLI commands that apply to WebApps:
+
+```azurecli-interactive
+az webapp --help
+```
+
+#### [Azure PowerShell](#tab/powershell)
+
+Run the following command to see a list of all Azure PowerShell cmdlets.
+
+```azurepowershell-interactive
+Get-Command -Module Az.*
+```
+
+Under `Azure` drive, the `Get-AzCommand` lists context-specific Azure commands.
+
+Run the following commands to get a list the Azure PowerShell commands that apply to WebApps.
+
+```azurepowershell-interactive
+cd 'Azure:/My Subscription/WebApps'
+Get-AzCommand
+```
+<!-- markdownlint-enable MD023 MD024 MD051-->
+
+---
+
+## Next steps
+
+- [Learn about Azure PowerShell][03]
+- [Learn about Azure CLI][02]
+- [Learn about persisting files in Cloud Shell][08]
+- [Learn about Azure Files storage][01]
+
+<!-- link references -->
+[01]: /azure/storage/files/storage-files-introduction
+[02]: /cli/azure/
+[03]: /powershell/azure/
+[04]: https://portal.azure.com/
+[05]: media/ephemeral/choose-shell.png
+[06]: media/ephemeral/getting-started.png
+[07]: media/ephemeral/shell-icon.png
+[08]: ../persisting-shell-storage.md