2021-06-14 00:19:47 +03:00
---
external help file: SnipeitPS-help.xml
Module Name: SnipeitPS
online version:
schema: 2.0.0
---
# Set-SnipeitStatus
## SYNOPSIS
Sets Snipe-it Status Labels
## SYNTAX
```
Set-SnipeitStatus [-id] < Int32 [ ] > [[-name] < String > ] [-type] < String > [[-notes] < String > ] [[-color] < String > ]
[[-show_in_nav] < Boolean > ] [[-default_label] < Boolean > ] [-url] < String > [-apiKey] < String > [-WhatIf]
[-Confirm] [< CommonParameters > ]
```
## DESCRIPTION
{{ Fill in the Description }}
## EXAMPLES
### EXAMPLE 1
```
Get-SnipeitStatus -search "Ready to Deploy"
```
### EXAMPLE 2
```
Set-SnipeitStatus -id 3 -name 'Waiting for arrival' -type pending
```
## PARAMETERS
2021-06-17 14:37:37 +03:00
### -apiKey
Users API Key for Snipeit, can be set using Set-SnipeitInfo command
2021-06-14 00:19:47 +03:00
```yaml
2021-06-17 14:37:37 +03:00
Type: String
2021-06-14 00:19:47 +03:00
Parameter Sets: (All)
Aliases:
Required: True
2021-06-17 14:37:37 +03:00
Position: 9
2021-06-14 00:19:47 +03:00
Default value: None
2021-06-17 14:37:37 +03:00
Accept pipeline input: False
2021-06-14 00:19:47 +03:00
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -color
Hex code showing what color the status label should be on the pie chart in the dashboard
2021-06-14 00:19:47 +03:00
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
2021-06-17 14:37:37 +03:00
Position: 5
2021-06-14 00:19:47 +03:00
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -default_label
1 or 0 - determine whether it should be bubbled up to the top of the list of available statuses
2021-06-14 00:19:47 +03:00
```yaml
2021-06-17 14:37:37 +03:00
Type: Boolean
2021-06-14 00:19:47 +03:00
Parameter Sets: (All)
Aliases:
2021-06-17 14:37:37 +03:00
Required: False
Position: 7
Default value: False
2021-06-14 00:19:47 +03:00
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -id
A id of specific Status Label
2021-06-14 00:19:47 +03:00
```yaml
2021-06-17 14:37:37 +03:00
Type: Int32[]
2021-06-14 00:19:47 +03:00
Parameter Sets: (All)
Aliases:
2021-06-17 14:37:37 +03:00
Required: True
Position: 1
2021-06-14 00:19:47 +03:00
Default value: None
2021-06-17 14:37:37 +03:00
Accept pipeline input: True (ByPropertyName)
2021-06-14 00:19:47 +03:00
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -name
{{ Fill name Description }}
2021-06-14 00:19:47 +03:00
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: False
2021-06-17 14:37:37 +03:00
Position: 2
2021-06-14 00:19:47 +03:00
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -notes
{{ Fill notes Description }}
2021-06-14 00:19:47 +03:00
```yaml
2021-06-17 14:37:37 +03:00
Type: String
2021-06-14 00:19:47 +03:00
Parameter Sets: (All)
Aliases:
Required: False
2021-06-17 14:37:37 +03:00
Position: 4
Default value: None
2021-06-14 00:19:47 +03:00
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -show_in_nav
1 or 0 - determine whether the status label should show in the left-side nav of the web GUI
2021-06-14 00:19:47 +03:00
```yaml
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
2021-06-17 14:37:37 +03:00
Position: 6
2021-06-14 00:19:47 +03:00
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -type
{{ Fill type Description }}
2021-06-14 00:19:47 +03:00
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: True
2021-06-17 14:37:37 +03:00
Position: 3
2021-06-14 00:19:47 +03:00
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -url
URL of Snipeit system, can be set using Set-SnipeitInfo command
2021-06-14 00:19:47 +03:00
```yaml
Type: String
Parameter Sets: (All)
Aliases:
Required: True
2021-06-17 14:37:37 +03:00
Position: 8
2021-06-14 00:19:47 +03:00
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -Confirm
Prompts you for confirmation before running the cmdlet.
2021-06-14 00:19:47 +03:00
```yaml
Type: SwitchParameter
Parameter Sets: (All)
2021-06-17 14:37:37 +03:00
Aliases: cf
2021-06-14 00:19:47 +03:00
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
2021-06-17 14:37:37 +03:00
### -WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
2021-06-14 00:19:47 +03:00
```yaml
Type: SwitchParameter
Parameter Sets: (All)
2021-06-17 14:37:37 +03:00
Aliases: wi
2021-06-14 00:19:47 +03:00
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