Configure Connection
Windows File System guide
Configure the folders NIM manages, verify access, and define the home-directory permissions assigned to users.
Before you beginDirect link to Before you begin
The NIM service account needs access to the local or remote shares and paths you intend to manage, plus management permissions for the file system operations your process will perform. Include share and DFS management access when using those operations.
NIM requires Path(s). Confirm that access works under the account running the NIM service.
Before targeting a production home-folder share, validate the configuration with a dedicated test folder and a test user.
Add the file system in NIMDirect link to Add the file system in NIM
-
Go to Systems > Overview and select Add.
-
Choose File System as the system type.
-
Enter a system name and save it.
-
In the Configured Systems pane, select Configure for the new system.
Set the managed folder pathDirect link to Set the managed folder path
In Connection, configure the following setting and save:
| NIM setting | Value |
|---|---|
| Path(s) | The local or remote paths NIM will collect and manage. The NIM service account must have access to each path. |
For home-folder provisioning, enter the path where NIM should create home folders. For example:
C:\HomeFolders
Configure multiple pathsDirect link to Configure multiple paths
Optionally, configure multiple paths with this format:
<path>[:<depth>][|<path>[:<depth>]...]
For example:
D:\Misc\FS-Test | \\?\UNC\prod.core.network\Storage\Users\J. Smith:2 | \\?\U:\:2 | \\prod.core.network\Storage\Users\J. Smith:2
The optional depth value determines the folder depth NIM uses for that path.
Test the connectionDirect link to Test the connection
-
Select Test Connection. NIM attempts to retrieve the configured paths.
-
Confirm that NIM returns a success message before continuing.
-
If the test fails, verify that each path exists and that the NIM service account can access it. Check network connectivity and share permissions for remote paths.
-
Collect the required file system data and review the results in NIM.
The connection test checks path retrieval. Validate folder changes, permission assignment, and share or DFS management separately with test resources before enabling automation.
Configure home-folder permissionsDirect link to Configure home-folder permissions
-
Open the Configuration tab.
-
In Access Profile 1, define the permissions that users should receive for their home directories.
-
If different groups or user types require different permissions, configure Access Profile 2 and Access Profile 3 as needed. Assign the applicable profile in a mapping using the FolderCreate function.
-
In the Available Tables pane, select Folders.
-
Select Save.
Validate folder creation and the resulting permissions with a test user. Confirm the NIM service account has the management access needed for each intended operation.