Plataformas de Redes Sociales

1. Open the Search & Replace Group Attributes tool by selecting theTOOLS |GROUPS | SEARCH &REPLACE menu command or shortcut bar icon.

2. Proceed to the Search Criteria tab and select an attribute to search. You may select from pre-defined common properties, or from the list of all Active Directory attributes which apply to groups. Please note that not all common properties are attributes and not all attributes are common properties. The list of common properties is much smaller but does include some items that cannot be changed by modifying an attribute, for example the password required flag.

3. Once you have selected an attribute or property to search and replace, you must specify the exact search criteria, i.e., what value to search for and what value to replace it with.

4. To force the tool to do an unconditional replace, you may optionally select (check) the

Replace Always checkbox from the Advanced Options group box. This will cause the tool to ignore any values placed in the Find What field and instead replace the attribute of all groups in the search domain with the replacement value.

5. Once you have specified the search criteria, proceed to the Search Locations tab page and select the ADD ITEMS button. You may select any container name (e.g., a

domain or OU) and/or any group name from the directory browser dialog.

6. To limit the search to just the immediate groups of the selected containers (i.e., to NOT search into any nested OUs or domains), you must change the Search Scope setting at the bottom of the page. Click the down arrow to change the scope to

Search Immediate Children.

7. To apply additional filters to the selected groups, proceed to the Filters tab page and select the Add Filters button. Note that these filters are applied before any of the search and replace criteria are applied.

8. To test the tool, use the RUN |RUN SIMULATION menu command or toolbar button.

The simulation process will verify that all the necessary data has been entered and will display any errors that would be encountered during an actual run.

NOTE: When running the simulation, the entire search process is performed but no actual user attributes are modified.

9. Once you have corrected any problems that the simulation exposed, select the RUN | RUN NOW menu command or toolbar button (or RUN |RUN LATER to schedule the

execution of the tool). The Search and Replace User Attributes tool will be launched and the user attributes will be modified based on the search criteria.

Search Criteria Tab

Use this tab to specify the properties or attributes to be replaced, the criteria to be used/met before replacing them, and finally the values to be used when replacing the attribute.

This tab contains the following search options:

Attribute to Search

Use this section to specify the common property or AD attribute to be used as the search criteria.

Common Property Select this option if you wish to select a common property to search and replace. Common properties are comprised of some of the more common AD attributes as well as several properties that cannot be modified directly by changing an AD attribute.

When this option is selected, use the arrow button to specify the common property to be searched.

AD Attribute Select this option if you wish to select an AD attribute to search and replace.

When this option is selected, use the arrow button to specify the AD attribute to be searched.

Search Criteria

Use this section to define what string/value is to be searched for and what string/value is to be used to replace it with.

Find What Enter the value you are looking for in the selected group attribute or common property.

Replace With Enter the value to place in the selected attribute/property if a match is found.

Advanced Options

Use this section to select advanced options for searching and replacing group attributes.

Replace always Check this box to force all specified groups to have their attributes replaced. Any other search criteria specified on this page will be ignored.

Note that the groups must still match any filters specified on the Filters tab page.

Replace if

attribute is empty

Check this box to search for an attribute that has no value or that is undefined. Any other search criteria specified on this page will be ignored.

Replace if attribute is not empty

Check this box to search for an attribute that has any value. Any other search criteria specified on this page will be ignored.

Remove the attribute

Check this box to have the attribute removed completely if it matched the search criteria.

Case Sensitive Click on this button to perform case sensitive searches on the selected attribute.

Match Whole String

Click on this button to indicate the attribute value must match exactly the string specified in the Find What field. If this option is not selected, the search will match if the Find What string is contained anywhere within the attribute value.

Search Locations Tab

Use this tab to specify where to search for the group attributes in Active Directory. You may browse AD to select specific domains or OUs or even groups using the SELECT

OBJECTS button.

This tab contains the following controls:

Select Domains/OUs Click on this button to select one or more Domains or OUs to search through. You may also use this buttton to select individual objects to search through. To do so, click on the down arrow on the right side of the button and select the

SELECT GROUPS menu item.

Remove Objects Click this button to remove all selected objects from the location list.

Import Objects Click this button to import one or more domain, OU or group names from a CSV file to populate the location list.

Location List This control contains a list of the currently selected locations to search. To add locations to this list, click on either the SELECT DOMAINS/OUS or IMPORT OBJECTS

button. To remove locations from this list, click on the

REMOVE OBJECTS button.

Search Scope Use the arrow button to define the scope of the search. The search scope determines whether the tool will search just the immediate children of any selected domain or OU, or if it will search the entire subtree of the selected

domains and OUs. The default search scope is to search the entire subtree.

Filters Tab

Use this tab to create one or more search filters. Search filters allow you to specify additional conditions that a group must match before their attributes get modified. The filters specified here are applied before the matching criteria specified on the Search Criteria tab.

This tab contains the following controls:

Add Filter Click this button to create a search filter and add it to the filter list. Selecting this button will display the Search Filter dialog allowing you to define additional conditions that a group must match before their attributes get modified. For more information, see Error! Reference source not

found. on page Error! Bookmark not defined..

Remove Filter Click this button to remove all selected filters from the filter list.

Modify Filter Click this button to modify the selected search filter.

Filter List This list contains all of the search filters you wish to apply.

Match All Filters Check this box if a group must match all the search filters before being processed. If this option is not checked, the group will be processed if it matches any one of the filters in the list.

Output Tab

Use this tab page to specify a screen output file. If you choose to write the screen output to a file, the entire contents of the tool’s output screen will be dumped to a text file

whenever the tool has completed execution. This is a handy method for documenting the changes made via ADtoolkit.

This tab contains the following information:

Screen Output File

Use this section to create a file containing the contents of the tool output screen.

Create a file containing the contents of the tool output screen

Check this box to have the Search and Replace Groups tool create a file with the contents of the tool output screen.

When this box is checked, the remaining fields/options in this section will become available.

Output File Name Enter the name of an output file or use the down arrow to select a name template.

Output File Directory

Enter the name of an output file directory or use the

Append to screen output file if it already exists

Check this checkbox to have the Search and Replace Groups tool append to the Screen output file, if it already exists. If the file does not already exist, a new one will be created. This option is selected by default.

Clear this checkbox to have the Search and Replace Groups tool overwrite any file with the same name.

Send To

Use this section to have the tool send an email upon completion containing the output file.

Send Output via Email

Check this option to have the tool automatically send an email upon completion of the tool's execution. You can optionally add the output window file as an attachment to the email.

To Click on this button to browse through Active Directory for an email address.

Send Output To The automatically generated email will be sent to the email address entered in this space. Use the TO button to the left of this field to browse for an email address in Active Directory.

Output Window Check this option to attach the output file to the email. This option will only be available if you have checked the option to create a screen output file.

Options Click on this button to launch a dialog box with optional email settings, such as the CC or BCC field.

M