Retrieving Patch-Rollout-Rules

Retrieves Patch-Rollout-Rule objects.


Examples:


Hint: The execution of these examples requires a connected PowerShell drive.


All Patch-Rollout-Rules defined can be retrieved using the cmdlet Get-EmdbPatchRolloutRule.


Get-EmdbPatchRolloutRule


As with other cmdlets, too, the returned Patch-Rollout-Rule-objects can be filtered. the following example just retrieves the 'Disabled Products - Rollout Rule' object:


Get-EmdbPatchRolloutRule -Path "Disabled Products - Rollout Rule"


or alternatively (and more easily) 


Get-EmdbPatchRolloutRule "Disabled Products - Rollout Rule"


Retrieve the Patch-Rollout-Rule "Pilot assignment critical Microsoft Patches" through its Item-ID (this ID will vary in different DSM environments):


Get-EmdbPatchRolloutRule -ItemID 4522


Tip: the alias ID can be used instead of ItemID.


Note: Note that Patch-Rollout-Rule-objects are Catalog-objects contained in rootCatalog and are therefore not part of the context rootDSE. As as consequence, they can be referenced without a full qualified path resp. an absolute path.


Starting with PSX 3.1 there was a new option implemented when retrieving Patch-Rollout-Rule objects. When specifying the SingleItemExpected-switch it is expected, that none or exactly one object is contained in the result. If the retrieval returns more than one object, an error is raised that can be caught and handled in scripts.