A number of factors determine a resource’s categorization. The text in the resource is evaluated against all the rules in the system. When a rule matches, its match strength is determined. This, in combination with the weight of the rule associated with a category, and the category threshold, determine whether a category is applied. When evaluating why a categorization is applied, it is important to understand these concepts and the relationships between them. For more information, see How Rules Affect Categorization.
You may want to examine a particular categorization for many reasons, including:
The Get-QClassificationAnalysis cmdlet returns results in a structured format for you to analyze. The following information is included:
tag | Description |
<Taxonomy> | The name of the taxonomy that contains the categories. |
<Category Name> | Identifies the category that is being analyzed. |
<Category ID> | Provides the ID so you can easily run more cmdlets on the category if needed, for example to modify the threshold or change a rule weight. |
<Applied> | Indicates whether the category was applied after all rules were taken into account. Only categories with at least one rule match are listed in the results. |
<Threshold> | The threshold value currently set on the category. The sum of the (rule weights x match strength) for all matching rules must equal or exceed this number for a category to be applied. For further explanation, see How Rules Affect Categorization. |
<Rule> | Identifies the rule that is being analyzed. All rules associated with category are listed, regardless of whether they match. |
<Name> | The name of the rule. |
<Match> | Indicates whether the rule matched. |
<Strength> | The strength of the rule match. This is used to calculate the value this rule contributes towards meeting the threshold, along with the rule weight. Match strength is set in the rule xml. For more information, see Writing XML Rules. |
<Weight> | The weight is part of the association between a rule and a category, and is used to calculate the value this rule contributes towards meeting the threshold, along with the match strength. You can change the rule weight using the Add-QRuleToCategory cmdlet. For more information, see Associating Rules to Categories. |
<Strength_x_Weight> | The value of this rule. The strength x weight is applied towards the threshold. If the sum of all rule values (for the rules associated with the category) exceeds the threshold, the category is applied. |
To examine the categorization of a resource:
Using the taxonomies available in your organization, resources can be automatically or manually categorized. You may need to examine the results of the automated system, or the way resources are being manually categorized by your users in order to evaluate the success of the system, and to help identify areas of improvement. For example, you may notice that a particular category is applied less often than you expect by the automated system. This may indicate that the rules attached to the categories in that taxonomy need some tweaking. You must be a Classification Analyst or Compliance Officer to use this view.
You may wish to view the categorization details of a resource to better understand the content. You may also wish to edit the categorization; for example, allowing the automated system to take over categorization if it has been overridden. Remember that business owners can manage the categorizations of their owned resources, and you should communicate with them as necessary to prevent your changes from being undone, or to gain further insight into a particular resource if required. If a manually categorized resource is owned, you can use the categorization details to understand how the automated system would categorize the resource. You may find it helpful to see how the system would work without disturbing the business owner’s categorization decisions.
The Categorized Resources view shows all scanned resources that have at least one category. You can only view and edit categories for governed resources. Resources can be placed under governance using the Manager by your Data Governance administrator. For more information, see Placing a Resource Under Governance of your Data Governance User Guide. |
Resources that are encrypted or password protected cannot be categorized. You can identify these resources in the View Provider log. A message will indicate that the file could not be filtered. For more information on retrieving logs, see Using the Classification Logs. |
Only SharePoint documents in libraries will be automatically categorized. Also, the contents of a list are shown as “list item”, regardless of the type of item in SharePoint. |
The Categorized Resources view allows you to start by choosing a category, and then filter down your results to get the information you need. You can use the following filters:
Filter | Description |
Include resources categorized with subcategories | In addition to the selected category, all subcategories and their nested categories will be included. For example, to display all resources categorized with a particular taxonomy, select the top level node, and then select this filter. |
Host | This narrows your results down to just those located on a particular server or SharePoint farm. You must enter the full, matching name. This is a case sensitive filter. You may find it helpful to first locate a resource on this host in the returned results, so you can see the exact name. |
Categorized by | This narrows your results down to resources categorized by a particular employee. You must enter this exactly as the employee is listed in the Categorized By column. For example, if the employee was shown as Smith, John you should enter exactly that, including matching the case. For this filter to work, make sure that Manual is selected in the categorization type, or that ”Any” is selected. |
Categorization type | This narrows your results down to the way the resource was categorized. If you want to see both types, select “Any”. To view inherited categorization, select “Manual”. |
To view and filter categorized resources in your environment
To view or edit a resource’s categorization from the Categorized Resources view
Before you put a category into production, you should ensure that it is properly configured and has the expected results. See Testing and Reviewing Automated Classification and Taxonomy Deployment Considerations for more details. Once you make it available for automated classification, any scans that start after this time will include the category. For any content that is being watched with changes, categorizations are possible after the next change.
Categories must be both published and automated in order for automated categorization to occur. |
To make a category available for automation
To make a category available for automation using PowerShell
Once documents are categorized, the system can classify them. Categorization is based on the content of a resource, while classification is based on the risk the resource poses. By classifying your unstructured data, you can begin to understand the security risks posed, and put policies in place to control these resources.
© 2025 One Identity LLC. ALL RIGHTS RESERVED. 使用条款 隐私 Cookie Preference Center