Skip to main content

Get Software Patch Installs Query

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 the software patch installs from the NinjaOne API.

SYNTAX

Get-NinjaOneSoftwarePatchInstalls [[-deviceFilter] <String>] [[-timeStamp] <DateTime>]
[[-timeStampUnixEpoch] <Int32>] [[-type] <String>] [[-impact] <String>] [[-status] <String>]
[[-productIdentifier] <String>] [[-installedBefore] <DateTime>] [[-installedBeforeUnixEpoch] <Int32>]
[[-installedAfter] <DateTime>] [[-installedAfterUnixEpoch] <Int32>] [[-cursor] <String>] [[-pageSize] <Int32>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Retrieves the software patch installs from the NinjaOne v2 API.

EXAMPLES

EXAMPLE 1

Get-NinjaOneSoftwarePatchInstalls

Gets all software patch installs.

EXAMPLE 2

Get-NinjaOneSoftwarePatchInstalls -deviceFilter 'org = 1'

Gets the software patch installs for the organisation with id 1.

EXAMPLE 3

Get-NinjaOneSoftwarePatchInstalls -timeStamp 1619712000

Gets the software patch installs with a monitoring timestamp at or after 1619712000.

EXAMPLE 4

Get-NinjaOneSoftwarePatchInstalls -type 'PATCH'

Gets the software patch installs with a type of 'PATCH'.

EXAMPLE 5

Get-NinjaOneSoftwarePatchInstalls -impact 'OPTIONAL'

Gets the software patch installs with an impact of 'OPTIONAL'.

EXAMPLE 6

Get-NinjaOneSoftwarePatchInstalls -status 'FAILED'

Gets the software patch installs with a status of 'FAILED'.

EXAMPLE 7

Get-NinjaOneSoftwarePatchInstalls -productIdentifier 23e4567-e89b-12d3-a456-426614174000

Gets the software patch installs with a product identifier of '23e4567-e89b-12d3-a456-426614174000'.

EXAMPLE 8

Get-NinjaOneSoftwarePatchInstalls -installedBefore (Get-Date)

Gets the software patch installs installed before the current date.

EXAMPLE 9

Get-NinjaOneSoftwarePatchInstalls -installedBeforeUnixEpoch 1619712000

Gets the software patch installs installed before 1619712000.

EXAMPLE 10

Get-NinjaOneSoftwarePatchInstalls -installedAfter (Get-Date)

Gets the software patch installs installed after the current date.

EXAMPLE 11

Get-NinjaOneSoftwarePatchInstalls -installedAfterUnixEpoch 1619712000

Gets the software patch installs installed after 1619712000.

PARAMETERS

-deviceFilter

Filter devices.

Type: String
Parameter Sets: (All)
Aliases: df

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

-timeStamp

Monitoring timestamp filter. PowerShell DateTime object.

Type: DateTime
Parameter Sets: (All)
Aliases: ts

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

-timeStampUnixEpoch

Monitoring timestamp filter. Unix Epoch time.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-type

Filter patches by patch status.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-impact

Filter patches by impact.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-status

Filter patches by patch status.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-productIdentifier

Filter patches by product identifier.

Type: String
Parameter Sets: (All)
Aliases:

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

-installedBefore

Filter patches to those installed before this date. PowerShell DateTime object.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 7
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: 7
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-installedAfter

Filter patches to those installed after this date. PowerShell DateTime object.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: 8
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: 8
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-cursor

Cursor name.

Type: String
Parameter Sets: (All)
Aliases:

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

-pageSize

Number of results per page.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: 10
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/softwarepatchinstallsquery