Skip to content

Latest commit

 

History

History
102 lines (67 loc) · 6.76 KB

SUPPORT.md

File metadata and controls

102 lines (67 loc) · 6.76 KB
Raw

Support

When creating the 'Compliance Utility', great care was taken to ensure quality and functionality. Extensive tests were carried out before publication to intercept and handle any errors. However, there is no guarantee that an error will not occur in a wide variety of configurations and environments.

Should you ever encounter a problem with the 'Compliance Utility', please use the information on this page to report it so that the problem can be resolved.

Microsoft Support Policy

Under this policy, the 'Compliance Utility' remains in support if the following criteria are met:

How to file issues and get help

The 'Compliance Utility' uses GitHub Issues to track problems and feature requests.

Please check for known issues before submitting new issues to avoid duplicates.

For new issues, file your bug or feature request as a new Issue. Please describe the Issue as detailed as possible. A screenshot of the error and/or a step-by-step description of how to reproduce a problem would be very helpful for this.

Known issues

  • Collecting labels and policies raise PowerShell error "not recognized as the name of a cmdlet"

    When you try to collect 'Labels and policies', you might see the following errors:

    Get-Label : The term 'Get-Label' is not recognized as the name of a cmdlet, function, script file, or operable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ Get-Label
+ ~~~~~~~~~
+ CategoryInfo          : ObjectNotFound: (Get-Label:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException

    Get-LabelPolicy : The term 'Get-LabelPolicy' is not recognized as the name of a cmdlet, function, script file, or operable
program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ Get-LabelPolicy
+ ~~~~~~~~~~~~~~~
+ CategoryInfo          : ObjectNotFound: (Get-LabelPolicy:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException

    This is due to the fact that permissions have expanded through roles in the Purview Compliance Portal.

    Additional information: Global Administrator, Permissions in the Microsoft Purview compliance portal

    Resolution: You must add the appropriate administrator (usually the global administrator) to the Information Protection roles group in the Microsoft Purview Compliance Center.

  • Set-ExecutionPolicy has no effect

    This applies only to a manual installation: If you downloaded the 'Compliance Utility' from its GitHub website, it will be extended by an Alternate Data Streams in NTFS (ADS). If the corresponding website in the ADS is not trusted in your environment, the PowerShell command "Set-ExecutionPolicy" has no effect.

    Resolution: Either you right-click the downloaded script files and "Unblock" it, or you add the corresponding website to your trusted site settings.

  • Script does not start and returns an error

    If you see this message in a PowerShell command window, you are most likely affected by the Windows® Group Policy setting "Turn on Script Execution":

    Set-ExecutionPolicy : PowerShell updated your local preference successfully, but the setting is overridden by the group
policy applied to your system or Set-ExecutionPolicy : Windows PowerShell updated your execution policy successfully,
but the setting is overridden by a policy defined at a more specific scope.

    Resolution: To resolve this problem, you must remove this Group Policy setting or configure a setting that allows scripts to run. Please request assistance from your administrator to do this. Please also read Use Group Policy to Manage Execution Policy and Set-ExecutionPolicy.

  • Installing PowerShellGet module cause an error

    This applies only to a manual installation. You may see the following error:

    PackageManagement\Install-Package : No match was found for the specified search criteria and module name 'PowerShellGet'.
Try Get-PSRepository to see all available registered module repositories.
At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PSModule.psm1:1772 char:21
+ ...          $null = PackageManagement\Install-Package @PSBoundParameters
+                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : ObjectNotFound: (Microsoft.Power....InstallPackage:InstallPackage) [Install-Package],
      Exception
    + FullyQualifiedErrorId : NoMatchFoundForCriteria,Microsoft.PowerShell.PackageManagement.Cmdlets.
      InstallPackage

    Resolution: To resolve this issue, you must run the following Windows PowerShell command to register the default module repositories:

    PS C:\> Register-PSRepository -Default

  • "powershell-7.3.4-osx-x64.pkg" can't be opened because Apple cannot check it for malicious software

    This applies only on Apple macOS: If you double-click the file the above message is displayed (the version may differ). It happens due to your Security & Privacy preferences.

    Resolution: To work around this issue, either you click "Open Anyway" in the general settings of your Security & Privacy preferences, or you request assistance from your administrator.