Skip to content

Commit 8dd2c64

Browse files
authored
Merge pull request #276510 from mbifeld/docs-editor/ephemeral-1716923659
Add pre-reqs section to New UI doc
2 parents 4c65a9c + c9ea497 commit 8dd2c64

File tree

2 files changed

+21
-3
lines changed

2 files changed

+21
-3
lines changed

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

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,24 +13,41 @@ sessions don't require a storage account. When your Cloud Shell session ends, wh
1313
after the window is closed or when Cloud Shell is restarted, all files you saved are deleted and
1414
don't persist across sessions.
1515

16+
## Prerequisites
17+
18+
Before you can use Azure Cloud Shell, you must register the **Microsoft.CloudShell** resource
19+
provider. Access to resources is enabled through provider namespaces that must be registered in your
20+
subscription. You only need to register the namespace once per subscription.
21+
22+
To see all resource providers, and the registration status for your subscription:
23+
24+
1. Sign in to the [Azure portal][04].
25+
1. On the Azure portal menu, search for **Subscriptions**. Select it from the available options.
26+
1. Select the subscription you want to view.
27+
1. On the left menu, under **Settings**, select **Resource providers**.
28+
1. In the search box, enter `cloudshell` to search for the resource provider.
29+
1. Select the **Microsoft.CloudShell** resource provider register from the provider list.
30+
1. Select **Register** to change the status from **unregistered** to **Registered**.
31+
32+
![Screenshot of selecting resource providers in the Azure portal.][09]
33+
1634
## Start Cloud Shell
1735

1836
1. Sign into the [Azure portal][04].
1937
1. Launch **Cloud Shell** from the top navigation of the Azure portal.
2038

2139
![Screenshot showing how to start Azure Cloud Shell in the Azure portal.][07]
22-
40+
2341
1. The first time you start Cloud Shell you're prompted to which shell to use. Select **Bash** or
2442
**PowerShell**.
2543

2644
![Screenshot showing the prompt to select the shell.][05]
27-
45+
2846
1. In the **Getting started** pane, select **No storage account required** for an ephemeral session.
2947
Using the dropdown menu, select the subscription you want to use for Cloud Shell, then select
3048
the **Apply** button.
3149

3250
![Screenshot showing the select subscription and optional storage prompt.][06]
33-
3451
### Set your subscription
3552

3653
1. List subscriptions you have access to.
@@ -120,3 +137,4 @@ Get-AzCommand
120137
[06]: media/ephemeral/getting-started.png
121138
[07]: media/ephemeral/shell-icon.png
122139
[08]: ../persisting-shell-storage.md
140+
[09]: media/ephemeral/resource-provider.png
69.1 KB
Loading

0 commit comments

Comments
 (0)