Skip to content

Commit 737960c

Browse files
committed
Updated text to meet Acrolinx score
1 parent 58fda97 commit 737960c

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

azure-local/manage/get-support-for-deployment-issues.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,14 @@ The following table outlines potential issues you might encounter during deploym
2525

2626
## Perform standalone log collection
2727

28-
If observability components have not been deployed or if you encounter issues during the system deployment or registration process, you can perform standalone log collection to collect and send diagnostic data to Microsoft for troubleshooting purposes. Make sure to file a support ticket before you proceed with the log collection.
28+
If observability components aren't deployed or you run into issues during system deployment or registration, perform standalone log collection to collect and send diagnostic data to Microsoft for troubleshooting. Make sure to file a support ticket before you start log collection.
2929

3030
Here are the high-level steps for standalone log collection:
3131

32-
1. As instructed by Microsoft Support, copy the requested diagnostic data from the Azure Local machine to a system which has connectivity to Azure.
32+
1. As instructed by Microsoft Support, copy the requested diagnostic data from the Azure Local machine to a system, which has connectivity to Azure.
3333
1. Use `Send-AzStackHciDiagnosticData` to transmit the copied diagnostic data to Microsoft for troubleshooting purposes. Microsoft can access that data after you file a support ticket.
3434

35-
If the observability feature is already configured, you can send diagnostic data to Microsoft using the on-demand log collection process. For instructions, see [Collect logs](./collect-logs.md). To explore additional log collection methods in Azure Local and understand when to use them, see [Diagnostics](../concepts/observability.md#diagnostics).
35+
If the observability feature is already set up, send diagnostic data to Microsoft using the on-demand log collection process. For instructions, see [Collect logs](./collect-logs.md). To learn about other log collection methods in Azure Local and when to use them, see [Diagnostics](../concepts/observability.md#diagnostics).
3636

3737
### Send logs to Microsoft
3838

@@ -44,7 +44,7 @@ You can use any of the following credentials to send logs:
4444

4545
#### Send logs using device code credentials
4646

47-
When you run the following command, you'll be prompted to open a web browser and enter the provided code to proceed with the authentication process.
47+
When you run the following command, you're prompted to open a web browser and enter the provided code to continue the authentication process.
4848

4949
```powershell
5050
Send-AzStackHciDiagnosticData -ResourceGroupName <ResourceGroupName> -SubscriptionId <SubscriptionId> -TenantId <TenantId> - RegistrationWithDeviceCode -DiagnosticLogPath <LogPath> -RegistrationRegion <RegionName> -Cloud <AzureCloud>
@@ -74,7 +74,7 @@ Send-AzStackHciDiagnosticData -ResourceGroupName <ResourceGroupName> -Subscripti
7474

7575
## Get remote support
7676

77-
In the pre-deployment or pre-registration scenarios, you are prompted to install and enable remote support via the Environment Checker to evaluate the readiness for deployment. If you enable remote support, Microsoft Support can connect to your device remotely and offer assistance. If you want to get remote support post-deployment of the system, see [Get remote support for Azure Local](./get-remote-support.md).
77+
In the pre-deployment or pre-registration scenarios, you're prompted to install and enable remote support via the Environment Checker to evaluate the readiness for deployment. If you enable remote support, Microsoft Support can connect to your device remotely and offer assistance. If you want to get remote support post-deployment of the system, see [Get remote support for Azure Local](./get-remote-support.md).
7878

7979
The high-level workflow to get remote support in the pre-deployment or pre-registration scenario is as follows:
8080

@@ -83,26 +83,26 @@ The high-level workflow to get remote support in the pre-deployment or pre-regis
8383

8484
### Enable remote support
8585

86-
Follow these steps to enable remote support:
86+
To enable remote support, follow these steps:
8787

8888
1. Establish a remote PowerShell session with the machine. Run PowerShell as administrator and run the following command:
8989

9090
```powershell
9191
Enter-PsSession -ComputerName <MachineName> -Credential $cred
9292
```
9393

94-
1. Run the following command to enable remote support. The sample Shared Access Signature (SAS) is provided by the Microsoft support team.
94+
1. To enable remote support, run the following command. The sample Shared Access Signature (SAS) is provided by the Microsoft support team.
9595

9696
```powershell
9797
Enable-AzStackHciRemoteSupport -AccessLevel <Diagnostics Or DiagnosticsRepair> -ExpireInMinutes <1440> -SasCredential <Sample SAS> -PassThru
9898
```
9999

100100
> [!NOTE]
101-
> When you run the command to enable remote support, you may get the following error:
101+
> When you run the command to enable remote support, you can get the following error:
102102
>
103103
> `Processing data from remote server <MachineName> failed with the following error message: The I/O operation has been aborted because of either a thread exit or an application request.`
104104
>
105-
> This means the Just Enough Administration (JEA) configuration has not been established. When you enable remote support, a service restart is required to activate JEA. During the remote support JEA configuration, the Windows Remote Management (WinRM) restarts twice, which may disrupt the PsSession to the machine. To resolve this error, wait for a few minutes before reconnecting to the remote machine and then run the `Enable-AzStackHciRemoteSupport` command again to enable remote support.
105+
> This means the Just Enough Administration (JEA) configuration isn't established. When you enable remote support, a service restart is required to activate JEA. During the remote support JEA configuration, Windows Remote Management (WinRM) restarts twice, which can disrupt the PsSession to the machine. To fix this error, wait a few minutes before reconnecting to the remote machine, and then run the `Enable-AzStackHciRemoteSupport` command again to enable remote support.
106106
>
107107
108108
For remote support usage scenarios, see [Enable remote support diagnostics](./get-remote-support.md#enable-remote-support-diagnostics) and [Other remote support operations](./get-remote-support.md#other-remote-support-operations).

0 commit comments

Comments
 (0)