Comments (12)
Agreed. I've read this about 10 times and having difficulty with it. And I would like to contribute to a re-write. But I don't fully understand the purpose of this tool.
from aadconnectconfigdocumenter.
HI @knowlesy14 , please submit a pull request with improved instructions and I'll review the updates. Thanks!
from aadconnectconfigdocumenter.
Perhaps change out "Pilot / Test" and "Target / Pilot" with "New".
And change out "Reference / Production" and "Baseline / Production" with "Existing".
from aadconnectconfigdocumenter.
Here's what I have so far:
Extract the zip file to an empty local folder on a machine which has .NET Framework 4.5 installed.
• Example: C:\Temp\AzureADConnectSyncDocumenter
• This will extract the Documenter files and sample data files for "Contoso".
• Run AzureADConnectSyncDocumenter-Contoso.cmd and ensure no errors are reported in AADConnectSyncDocumenter-Error.log
• This CMD doesn’t make any changes. It simply reads sample data from the Contoso directory and creates AADConnectSyncDocumenter.log
• Export the Server Configuration of your new or existing Azure AD Connect server by running Get-ADSyncServerConfiguration cmdlet defined in ADSync module shipped with Azure AD Connect.
Import-Module ADSync
Get-ADSyncServerConfiguration -Path ""
Example: Get-ADSyncServerConfiguration -Path “C:\temp\AzureADConnectSyncDocumenter\Output”
from aadconnectconfigdocumenter.
• Go to C:\temp\AzureADConnectSyncDocumenter and create a new folder next to Contoso with your company name.
• If you are upgrading your server to a new version of Azure AD Connect, then…..
• This is where I get a bit lost. Do we upgrade AD Connect then rerun the Documenter.cmd? And then do a comparison with the Report.html?
from aadconnectconfigdocumenter.
So then I did some word swaps, but it's kind of confusing at this point.
• Copy the configuration export files from the Output folder to a folder under the "Data" directory of the Documenter tool.
o e.g. the "New" configuration files for the customer "Contoso" are provided as a sample under the "Data\Contoso\New" folder. This is the folder where the files of the new configuration is located. So, for example, in a swing migration project the "New" configuration will be the configuration of the "old" server, since the goal is to build a new server with the configuration as close to the old server as possible.
• If you want to document the changes from a specific baseline, export the server configuration of your existing Azure AD Connect server and copy the output to a folder under the Documenter "Data" directory.
o e.g. the "Existing" configuration files for the customer "Contoso" are provided as a sample under the "Data\Contoso\Existing" folder. This is the folder where the files of the existing configuration is located.
• Make a copy of AzureADConnectSyncDocumenter-Contoso.cmd with a name appropriate for your environment (say AzureADConnectSyncDocumenter-Fabrikam.cmd) and edit the folder paths for "New" and "Existing" with your Fabrikam name.
o If you don't have a existing config, specify the same path as the "New" config.
• Run your updated batch file. Upon successful execution, the generated report will be found in the Documenter "Report" folder.
• View the HTML file and somehow a difference will be shown.
from aadconnectconfigdocumenter.
Thanks for taking the time to create this tool!
I gave up using it since I don't understand the documentation.
Does anybody know of alternative tools?
I just need a simple report of the configuration of an existing Azure AD Connect installation, nothing else
Currently, I use screenshots which is not great.
Regards Peter
from aadconnectconfigdocumenter.
Your usecase is simple to explain. The tool's executable expects two sets of input configuration files to be provided in it's "Data" folder, let's call them A and B. In your case B is same as A. So on the commandline you'll be running is: AzureADConnectSyncDocumenterCmd.exe "A" "A". That is all. Again, if your config files are placed in the folder "FABRIKAM\07JUL2021" then you'd run: AzureADConnectSyncDocumenterCmd.exe "FABRIKAM\07JUL2021" "FABRIKAM\07JUL2021"..
It's only when you have two different sets of config files and would be interested to understand how the changes are reported and in the PowerShell script that it also produces for recreating sync rules that it becomes super important what you call as A and what you call as B and it can get quite confusing which is A and which is B based on what you are exactly trying to do - promote the change from test to prod, staging to prod, prod to staging, swing migration, etc.. The terminology for naming A=Pilot/Target and B=Production/Baseline is carried over from FIM/MIM world.
from aadconnectconfigdocumenter.
Hi, I couldn't use it as it's confusing. Could you please simplify how to execute the report after export the config files?
Maybe a screenshot of it would fix all the confusion.
from aadconnectconfigdocumenter.
After much thought, I've just documented the instructions separately for four different main use cases. Hopefully this is clearer and helpful.
from aadconnectconfigdocumenter.
Would you please provide a link to the documentation instructions for the 4 different main use cases? I don't see it.
from aadconnectconfigdocumenter.
Hi @texaskat, updates were on the wiki tab homepage, but now visible on the project homepage as well.
from aadconnectconfigdocumenter.
Related Issues (20)
- wrong (old) ExportDeletionThresholdValue value HOT 3
- Options HOT 4
- Minor point of confusion : Naming of cmd files HOT 2
- Does not support running on a machine with AADConnect v1.2.70.0 installed HOT 5
- Missing command-line arguments for pilot/production folders HOT 2
- Single quotes in AADConnect Rule Names lead to System.Xml.XPath.XPathException HOT 1
- Error with Report HOT 1
- Group filter group HOT 6
- Target/Pilot and Reference/Production names are confusing and not consistently referenced in the tool HOT 2
- Typo in Sync Rule Change script HOT 2
- Unsupported changes detected in Sync Rule Change script HOT 4
- Error when running the report again HOT 2
- Add HOT 1
- I am not able to find the .cmd file to edit the only one I get is the conteso file. tried several. I agree that there are confusing instructions or something. HOT 1
- LDAP
- Does this tool captures changes in the OU scope ? HOT 1
- This repo is missing important files
- PowerShell Deployment Script HOT 1
- Possible issue with End to End attribute Flows Summary tables
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from aadconnectconfigdocumenter.