Skip to content

Commit 3b7865f

Browse files
authored
fix code and alignment
1 parent 1ce68d2 commit 3b7865f

File tree

1 file changed

+25
-15
lines changed

1 file changed

+25
-15
lines changed

articles/active-directory/cloud-provisioning/how-to-troubleshoot.md

Lines changed: 25 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,11 @@ ms.technology: identity-adfs
1111
---
1212

1313
# Cloud provisioning troubleshooting
14+
1415
Cloud provisioning touches many different things and has many different dependencies. Naturally, this can give rise to various issues. This document is designed to get you started on troubleshooting these issues. This document will introduce you to the typical areas that you should focus on, how to gather additional information, and various techniques that can be used to track down problems.
1516

1617

17-
## Common troubleshooting areas
18+
## Common troubleshooting areas
1819

1920
|Name|Description|
2021
|-----|-----|
@@ -35,6 +36,7 @@ Some of the first things that you want to verify with the agent are:
3536
These items can be verified in the Azure portal and on the local server that is running the agent.
3637

3738
### Azure portal agent verification
39+
3840
To verify the agent is being seen by Azure and is healthy follow these steps:
3941

4042
1. Sign in to the Azure portal.
@@ -46,6 +48,7 @@ To verify the agent is being seen by Azure and is healthy follow these steps:
4648
![Provisioning agents](media/how-to-install/install8.png)</br>
4749

4850
### Verify the port
51+
4952
To verify the Azure is listening on port 443 and that your agent can communicate with it, you can use the following tool:
5053

5154
https://aadap-portcheck.connectorporttest.msappproxy.net/
@@ -54,16 +57,19 @@ This test will verify that your agents are able to communicate with Azure over p
5457
![Services](media/how-to-install/verify2.png)
5558

5659
### On the local server
60+
5761
To verify that the agent is running follow these steps:
5862

5963
1. On the server with the agent installed, open **Services** by either navigating to it or by going to Start/Run/Services.msc.
6064
2. Under **Services**, make sure **Microsoft Azure AD Connect Agent Updater** and **Microsoft Azure AD Connect Provisioning Agent** are there and the status is **Running**.
6165
![Services](media/how-to-troubleshoot/troubleshoot1.png)
6266

6367
### Common agent installation issues
68+
6469
The following are some common agent installation issues and what the typical resolution is.
6570

6671
#### Agent failed to start
72+
6773
If you receive an error message that states:
6874

6975
**Service 'Microsfoft Azure AD Connect Provisioning Agent' failed to start. Verify that you have sufficient privileges to start the system services.**
@@ -80,6 +86,7 @@ To resolve this, use the following steps:
8086
![Services](media/how-to-troubleshoot/troubleshoot3.png)
8187

8288
#### Agent times out or certificate is invalid
89+
8390
You may get the following errors if you are attempting to register the agent.
8491

8592
![Services](media/how-to-troubleshoot/troubleshoot4.png)
@@ -90,26 +97,28 @@ The Provisioning Agent supports use of outbound proxy. You can configure it by e
9097
Add the following lines into it, towards the end of the file just before the closing `</configuration>` tag.
9198
Replace the variables [proxy-server] and [proxy-port] with your proxy server name and port values.
9299

93-
```xml
94-
<system.net>
95-
<defaultProxy enabled="true" useDefaultCredentials="true">
96-
<proxy
97-
usesystemdefault="true"
98-
proxyaddress="http://[proxy-server]:[proxy-port]"
99-
bypassonlocal="true"
100-
/>
101-
</defaultProxy>
102-
</system.net>
103-
```
100+
```xml
101+
<system.net>
102+
<defaultProxy enabled="true" useDefaultCredentials="true">
103+
<proxy
104+
usesystemdefault="true"
105+
proxyaddress="http://[proxy-server]:[proxy-port]"
106+
bypassonlocal="true"
107+
/>
108+
</defaultProxy>
109+
</system.net>
110+
```
104111

105112
#### Agent registration fails with security error
113+
106114
You may see the following error when installing the cloud provisioning agent.
107115

108116
This is typically caused by the agent being unable to execute the PowerShell registration scripts due to local PowerShell execution policies.
109117

110118
To resolve this, change the PowerShell execution policies on the server. You need to have Machine and User policies as "Undefined" or "RemoteSigned". If it is “Unrestricted” you will see this error. For more information see [PowerShell execution policies](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-6).
111119

112120
### Log files
121+
113122
By default, the agent emits very minimal error messages and stack trace information. You can find these trace logs in the folder: **C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace**
114123

115124
Use the following steps to gather additional details for troubleshooting agent-related issues.
@@ -145,9 +154,11 @@ Use the following steps to gather additional details for troubleshooting agent-r
145154
Get-Content “C:/ProgramData/Microsoft/Azure AD Connect Provisioning Agent/Trace/ProvAgentTrace.log” -Wait
146155
```
147156
## Object synchronization issues
157+
148158
The following section contains information on troubleshooting object synchronization.
149159

150160
### Provisioning logs
161+
151162
In the Azure portal, provisioning logs can be used to help track down and troubleshoot object synchronization issues. To view the logs, select **Logs**.
152163
![Provisioning logs](media/how-to-troubleshoot/log1.png)
153164

@@ -176,12 +187,11 @@ By clicking on the status, you can see additional information about the quaranti
176187

177188
- Use the Azure portal to restart the provisioning job. On the agent configuration page select **Restart provisioning**.
178189

179-
180-
![Quarantine](media/how-to-troubleshoot/quarantine3.png)
190+
![Quarantine](media/how-to-troubleshoot/quarantine3.png)
181191

182192
- Use Microsoft Graph to [restart the provisioning job](https://docs.microsoft.com/graph/api/synchronization-synchronizationjob-restart?view=graph-rest-beta&tabs=http). You'll have full control over what you restart. You can choose to clear escrows (to restart the escrow counter that accrues toward quarantine status), clear quarantine (to remove the application from quarantine), or clear watermarks. Use the following request:
183193

184-
`POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/restart`
194+
`POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/restart`
185195

186196
## Next steps
187197

0 commit comments

Comments
 (0)