Devices

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

Creates a staged device.

SYNTAX

New-NinjaOneStagedDevice [-StagedDevice] <Object> [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Creates a staged device via the NinjaOne v2 API.

EXAMPLES

EXAMPLE 1

New-NinjaOneStagedDevice -StagedDevice @{ deviceIdentifier = 'DEVICE-001'; organizationId = 1 }

Creates a staged device.

EXAMPLE 2

# FULL REQUEST EXAMPLE (AUTO-GENERATED) - BEGIN
 PS> $body = @{
	name = "string"
	orgId = 0
	locationId = 0
	roleId = 0
	assignedUserUid = "00000000-0000-0000-0000-000000000000"
	warrantyStartDate = 0
	warrantyEndDate = 0
	itamAssetId = "string"
	itamAssetStatus = "string"
	itamAssetPurchaseDate = 0
	itamAssetPurchaseAmount = 0
	itamAssetExpectedLifetime = "string"
	itamAssetEndOfLifeDate = 0
	itamAssetSerialNumber = "string"
}
PS> New-NinjaOneStagedDevice -StagedDevice $body
# FULL REQUEST EXAMPLE (AUTO-GENERATED) - END

Full request example (auto-generated).

PARAMETERS

-StagedDevice

Staged device configuration per API schema

Type: Object
Parameter Sets: (All)
Aliases: body

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
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 created staged device information.

NOTES

RELATED LINKS

https://docs.homotechsual.dev/modules/ninjaone/commandlets/New/stageddevice