@@ -13,24 +13,41 @@ sessions don't require a storage account. When your Cloud Shell session ends, wh
13
13
after the window is closed or when Cloud Shell is restarted, all files you saved are deleted and
14
14
don't persist across sessions.
15
15
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
+
16
34
## Start Cloud Shell
17
35
18
36
1 . Sign into the [ Azure portal] [ 04 ] .
19
37
1 . Launch ** Cloud Shell** from the top navigation of the Azure portal.
20
38
21
39
![ Screenshot showing how to start Azure Cloud Shell in the Azure portal.] [ 07 ]
22
-
40
+
23
41
1 . The first time you start Cloud Shell you're prompted to which shell to use. Select ** Bash** or
24
42
** PowerShell** .
25
43
26
44
![ Screenshot showing the prompt to select the shell.] [ 05 ]
27
-
45
+
28
46
1 . In the ** Getting started** pane, select ** No storage account required** for an ephemeral session.
29
47
Using the dropdown menu, select the subscription you want to use for Cloud Shell, then select
30
48
the ** Apply** button.
31
49
32
50
![ Screenshot showing the select subscription and optional storage prompt.] [ 06 ]
33
-
34
51
### Set your subscription
35
52
36
53
1 . List subscriptions you have access to.
@@ -120,3 +137,4 @@ Get-AzCommand
120
137
[ 06 ] : media/ephemeral/getting-started.png
121
138
[ 07 ] : media/ephemeral/shell-icon.png
122
139
[ 08 ] : ../persisting-shell-storage.md
140
+ [ 09 ] : media/ephemeral/resource-provider.png
0 commit comments