Skip to content

Commit 5da3227

Browse files
LouisBernerLouisBerner
committed
Edit pass.
1 parent 537978d commit 5da3227

File tree

1 file changed

+71
-72
lines changed

1 file changed

+71
-72
lines changed

‎azure-local/manage/connect-arc-vm-using-ssh.md

Lines changed: 71 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -32,81 +32,80 @@ Before you begin, ensure that you:
3232

3333
### Install the OpenSSH Server Extension via Azure portal
3434

35-
To install the extension via Azure portal, select the **OpenSSH for Windows - Azure Arc** option.
35+
To install the extension via Azure portal, navigate to Extensions and select the **OpenSSH for Windows - Azure Arc** option.
3636

3737
:::image type="content" source="./media/connect-arc-vm-using-ssh/install-open-ssh-server-1.png" alt-text="Screenshot of the Azure Arc Extensions page." lightbox="./media/connect-arc-vm-using-ssh/install-open-ssh-server-1.png":::
3838

39-
4039
### Install the OpenSSH Server Extension via PowerShell
4140

42-
Use the following steps to install the OpenSSH Server Extension via PowerShell
43-
44-
1. Open a Windows PowerShell session as an administrator.
45-
46-
1. Run the following cmdlets to ensure that the required Azure CLI Extensions are installed:
47-
48-
```powershell
49-
az extension add --upgrade --name connectedmachine
50-
az extension add --upgrade --name ssh
51-
```
52-
53-
1. Sign in to Azure:
54-
55-
```powershell
56-
az login --use-device-code
57-
```
58-
59-
1. Set appropriate parameters:
60-
61-
```powershell
62-
$resourceGroup="<your resource group>"
63-
$serverName = "<your server name>"
64-
$location = "<your location>"
65-
$localUser = "Administrator" # Use a local admin account for testing
66-
```
67-
68-
1. Install the `OpenSSH` Arc Extension:
69-
70-
```powershell
71-
az connectedmachine extension create --name WindowsOpenSSH
72-
--type WindowsOpenSSH --publisher Microsoft.Azure.OpenSSH --type-handler-version 3.0.1.0 --machine-name $serverName --resource-group $resourceGroup
73-
```
74-
75-
Here's a sample output:
76-
77-
```powershell
78-
PS C:\Users\labadmin> az connectedmachine extension create --name WindowsOpenSSH --location westeurope --type WindowsOpenSSH --publisher Microsoft.Azure.OpenSSH --type-handler-version 3.0.1.0 --machine-name $serverName --resource-group $resourceGroup
79-
{
80-
"id": "/subscriptions/<SubscriptionName>/resourceGroups/<ResourceGroupName>/providers/<ProviderName>/machines/<MachineName>/extensions/WindowsOpenSSH",
81-
"location": "westeurope",
82-
"name": "WindowsOpenSSH",
83-
"properties": {
84-
"autoUpgradeMinorVersion": false,
85-
"enableAutomaticUpgrade": true,
86-
"instanceView": {
87-
"name": "WindowsOpenSSH",
88-
"status": {
89-
"code": "0",
90-
"level": "Information",
91-
"message": "Extension Message: OpenSSH Successfully enabled"
92-
},
93-
"type": "WindowsOpenSSH",
94-
"typeHandlerVersion": "3.0.1.0"
95-
},
96-
"provisioningState": "Succeeded",
97-
"publisher": "Microsoft.Azure.OpenSSH",
98-
"type": "WindowsOpenSSH",
99-
"typeHandlerVersion": "3.0.1.0",
100-
},
101-
"resourceGroup": "<ResourceGroupName>",
102-
"type": "Microsoft.HybridCompute/machines/extensions"
103-
}
104-
PS C:\Users\labadmin>
105-
```
106-
107-
1. You can see `WindowsOpenSSH` Extension in the Azure portal Extensions list view.
108-
109-
:::image type="content" source="./media/connect-arc-vm-using-ssh/azure-portal-extensions-list-view-3.png" alt-text="Screenshot of Azure portal Extensions list view." lightbox="./media/connect-arc-vm-using-ssh/azure-portal-extensions-list-view-3.png":::
41+
Use the following steps to install the OpenSSH Server Extension via PowerShell
42+
43+
1. Open a Windows PowerShell session as an administrator.
44+
45+
1. Run the following cmdlets to ensure that the required Azure CLI Extensions are installed:
46+
47+
```powershell
48+
az extension add --upgrade --name connectedmachine
49+
az extension add --upgrade --name ssh
50+
```
51+
52+
1. Sign in to Azure:
53+
54+
```powershell
55+
az login --use-device-code
56+
```
57+
58+
1. Set appropriate parameters:
59+
60+
```powershell
61+
$resourceGroup="<your resource group>"
62+
$serverName = "<your server name>"
63+
$location = "<your location>"
64+
$localUser = "Administrator" # Use a local admin account for testing
65+
```
66+
67+
1. Install the `OpenSSH` Arc Extension:
68+
69+
```powershell
70+
az connectedmachine extension create --name WindowsOpenSSH
71+
--type WindowsOpenSSH --publisher Microsoft.Azure.OpenSSH --type-handler-version 3.0.1.0 --machine-name $serverName --resource-group $resourceGroup
72+
```
73+
74+
Here's a sample output:
75+
76+
```powershell
77+
PS C:\Users\labadmin> az connectedmachine extension create --name WindowsOpenSSH --location westeurope --type WindowsOpenSSH --publisher Microsoft.Azure.OpenSSH --type-handler-version 3.0.1.0 --machine-name $serverName --resource-group $resourceGroup
78+
{
79+
"id": "/subscriptions/<SubscriptionName>/resourceGroups/<ResourceGroupName>/providers/<ProviderName>/machines/<MachineName>/extensions/WindowsOpenSSH",
80+
"location": "westeurope",
81+
"name": "WindowsOpenSSH",
82+
"properties": {
83+
"autoUpgradeMinorVersion": false,
84+
"enableAutomaticUpgrade": true,
85+
"instanceView": {
86+
"name": "WindowsOpenSSH",
87+
"status": {
88+
"code": "0",
89+
"level": "Information",
90+
"message": "Extension Message: OpenSSH Successfully enabled"
91+
},
92+
"type": "WindowsOpenSSH",
93+
"typeHandlerVersion": "3.0.1.0"
94+
},
95+
"provisioningState": "Succeeded",
96+
"publisher": "Microsoft.Azure.OpenSSH",
97+
"type": "WindowsOpenSSH",
98+
"typeHandlerVersion": "3.0.1.0",
99+
},
100+
"resourceGroup": "<ResourceGroupName>",
101+
"type": "Microsoft.HybridCompute/machines/extensions"
102+
}
103+
PS C:\Users\labadmin>
104+
```
105+
106+
6. You can see `WindowsOpenSSH` Extension in the Azure portal Extensions list view.
107+
108+
:::image type="content" source="./media/connect-arc-vm-using-ssh/azure-portal-extensions-list-view-3.png" alt-text="Screenshot of Azure portal Extensions list view." lightbox="./media/connect-arc-vm-using-ssh/azure-portal-extensions-list-view-3.png":::
110109
111110
## Use SSH to connect to Azure Local
112111
@@ -127,7 +126,7 @@ Use the following steps to connect to Azure Local.
127126

128127
## Use RDP over SSH to connect to Azure Local
129128

130-
1. To sign into Azure Local using RDP, run the following command with the RDP parameter:
129+
1. To sign into Azure Local using RDP over SSH, run the following command with the RDP parameter:
131130

132131
```powershell
133132
az ssh arc --resource-group $resourceGroup --name $serverName --local-user $localUser --rdp
@@ -143,7 +142,7 @@ Use the following steps to connect to Azure Local.
143142

144143
:::image type="content" source="./media/connect-arc-vm-using-ssh/rdp-desktop-for-ssh-arc-connection-9.png" alt-text="Screenshot of the RDP desktop to connect to Windows Server over SSH." lightbox="./media/connect-arc-vm-using-ssh/rdp-desktop-for-ssh-arc-connection-9.png":::
145144

146-
You have set up an RDP tunnel over SSH into your Azure Local using Azure CLI without any VPN or open ports at your firewall.
145+
You set up an RDP tunnel over SSH into your Azure Local using Azure CLI without any VPN or open ports at your firewall.
147146

148147
## Next steps
149148

0 commit comments

Comments
 (0)