Skip to main content

Device OS Patch Installs

Generated Cmdlet Help

This page has been generated from the NinjaOne PowerShell module source. To make changes please edit the appropriate PowerShell source file.

SYNOPSIS​

Gets device OS patch installs from the NinjaOne API.

SYNTAX​

Get-NinjaOneDeviceOSPatchInstalls [-deviceId] <Int32> [[-status] <String>] [[-installedBefore] <DateTime>]
[[-installedBeforeUnixEpoch] <Int32>] [[-installedAfter] <DateTime>] [[-installedAfterUnixEpoch] <Int32>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Retrieves device OS patch installs from the NinjaOne v2 API. If you want patch install status for multiple devices please check out the related 'queries' commandlet Get-NinjaOneOSPatchInstalls.

EXAMPLES​

EXAMPLE 1​

Get-NinjaOneDeviceOSPatchInstalls -deviceId 1

Gets OS patch installs for the device with id 1.

EXAMPLE 2​

Get-NinjaOneDeviceOSPatchInstalls -deviceId 1 -status 'FAILED' -installedAfter (Get-Date 2022/01/01)

Gets OS patch installs for the device with id 1 where the patch failed to install after 2022-01-01.

PARAMETERS​

-deviceId​

Device id to get OS patch install information for.

Type: Int32
Parameter Sets: (All)
Aliases: id

Required: True
Position: 1
Default value: 0
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-status​

Filter patches by patch status.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-installedBefore​

Filter patches to those installed before this date. Expects DateTime or Int.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-installedBeforeUnixEpoch​

Filter patches to those installed after this date. Unix Epoch time.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-installedAfter​

Filter patches to those installed after this date. Expects DateTime or Int.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-installedAfterUnixEpoch​

Filter patches to those installed after this date. Unix Epoch time.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

A powershell object containing the response.​

NOTES​

https://docs.homotechsual.dev/modules/ninjaone/commandlets/Get/deviceospatchinstalls