--- external help file: SnipeitPS-help.xml Module Name: SnipeitPS online version: schema: 2.0.0 --- # Set-SnipeitAsset ## SYNOPSIS Update a specific Asset in the Snipe-it asset system ## SYNTAX ``` Set-SnipeitAsset [-id] [[-asset_tag] ] [[-name] ] [[-status_id] ] [[-model_id] ] [[-last_checkout] ] [[-assigned_to] ] [[-company_id] ] [[-serial] ] [[-order_number] ] [[-warranty_months] ] [[-purchase_cost] ] [[-purchase_date] ] [[-supplier_id] ] [[-requestable] ] [[-archived] ] [[-rtd_location_id] ] [[-notes] ] [[-RequestType] ] [[-image] ] [-image_delete] [[-url] ] [[-apiKey] ] [[-customfields] ] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION Long description ## EXAMPLES ### EXAMPLE 1 ``` Set-SnipeitAsset -id 1 -status_id 1 -model_id 1 -name "Machine1" ``` ### EXAMPLE 2 ``` Set-SnipeitAsset -id 1 -name "Machine1" -customfields = @{ "_snipeit_os_5" = "Windows 10 Pro" ; "_snipeit_os_version" = "1909" } ``` ### EXAMPLE 3 ``` Get-SnipeitAsset -serial 12345678 | Set-SnipeitAsset -notes 'Just updated' ``` ## PARAMETERS ### -apiKey Deprecated parameter, please use Connect-SnipeitPS instead. Users API Key for Snipeit. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 22 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -archived Whether or not the asset is archived. Archived assets cannot be checked out and do not show up in the deployable asset screens ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: 16 Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -asset_tag New tag for asset. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 2 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -assigned_to The id of the user the asset is currently checked out to ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 7 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -company_id The id of an associated company id ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 8 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -customfields Hastable of custom fields and extra fields that need passing through to Snipeit ```yaml Type: Hashtable Parameter Sets: (All) Aliases: CustomValues Required: False Position: 23 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -id ID of the Asset or array of IDs ```yaml Type: Int32[] Parameter Sets: (All) Aliases: Required: True Position: 1 Default value: None Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` ### -image Image file name and path for item ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 20 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -image_delete Remove current image ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -last_checkout Date the asset was last checked out ```yaml Type: DateTime Parameter Sets: (All) Aliases: Required: False Position: 6 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -model_id Model ID of the asset, this can be got using Get-Model ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 5 Default value: 0 Accept pipeline input: False Accept wildcard characters: False ``` ### -name Asset name ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 3 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -notes Notes about asset ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 18 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -order_number Order number for the asset ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 10 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -purchase_cost Purchase cost of the asset, without a currency symbol ```yaml Type: Double Parameter Sets: (All) Aliases: Required: False Position: 12 Default value: 0 Accept pipeline input: False Accept wildcard characters: False ``` ### -purchase_date Date of asset purchase ```yaml Type: DateTime Parameter Sets: (All) Aliases: Required: False Position: 13 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -requestable Whether or not the asset can be requested by users with the permission to request assets ```yaml Type: Boolean Parameter Sets: (All) Aliases: Required: False Position: 15 Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -RequestType Http request type to send Snipe IT system. Defaults to Patch you could use Put if needed. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 19 Default value: Patch Accept pipeline input: False Accept wildcard characters: False ``` ### -rtd_location_id The id that corresponds to the location where the asset is usually located when not checked out ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 17 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -serial Serial number of the asset ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 9 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -status_id Status ID of the asset, this can be got using Get-Status ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 4 Default value: 0 Accept pipeline input: False Accept wildcard characters: False ``` ### -supplier_id Supplier id of the Asset ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 14 Default value: 0 Accept pipeline input: False Accept wildcard characters: False ``` ### -url Deprecated parameter, please use Connect-SnipeitPS instead. URL of Snipeit system. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: 21 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -warranty_months Number of months for the asset warranty ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: 11 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Confirm Prompts you for confirmation before running the cmdlet. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: cf Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: wi 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ## OUTPUTS ## NOTES ## RELATED LINKS