Skip to content

Deprecations#

Deprecations for v3#

Rule output object#

Several properties of the rule object have been renamed to improve consistency with other objects. Previously rules returned by Get-PSRule returned a rule object which included the following properties:

  • RuleId
  • RuleName
  • Description

These have been replaced with the following properties:

  • Id instead of RuleId.
  • Name instead of RuleName.
  • Synopsis instead of Description.

The changes apply from v2, however the old properties are still available for backwards compatibility. From v3 these properties will be removed. These changes do not affect normal usage of PSRule. Supporting scripts that directly use the old names may not work correctly until you update these names.

Deprecations for v2#

Default baseline by module manifest#

When packaging baselines in a module, you may want to specify a default baseline. PSRule v1.9.0 added support for setting the default baseline in a module configuration.

Previously a default baseline could be set by specifying the baseline in the module manifest. From v1.9.0 this is deprecated and will be removed from v2.

For details on how to migrate to the new default baseline option, continue reading the upgrade notes.

Resources without an API version#

When creating YAML and JSON resources you define a resource by specifying the apiVersion and kind. To allow new schema versions for resources to be introduced in the future, an apiVersion was introduced. For backwards compatibility, resources without an apiVersion deprecated but supported. From v2 resources without an apiVersion will be ignored.

For details on how to add an apiVersion to a resource, continue reading the upgrade notes.

Last update: 2022-03-17