updated docs

This commit is contained in:
Petri Asikainen 2021-06-09 21:08:18 +03:00
parent d6a8289241
commit a27f20f0cd
8 changed files with 78 additions and 40 deletions

View file

@ -1,38 +1,37 @@
<#
.SYNOPSIS
# Gets a list of Snipe-it Manufacturers
.SYNOPSIS
# Gets a list of Snipe-it Manufacturers
.PARAMETER search
A text string to search the Manufactures data
.PARAMETER search
A text string to search the Manufactures data
.PARAMETER id
A id of specific Manufactuter
.PARAMETER id
A id of specific Manufactuter
.PARAMETER limit
Specify the number of results you wish to return. Defaults to 50. Defines batch size for -all
.PARAMETER limit
Specify the number of results you wish to return. Defaults to 50. Defines batch size for -all
.PARAMETER offset
Offset to use
.PARAMETER offset
Offset to use
.PARAMETER all
A return all results, works with -offset and other parameters
.PARAMETER all
A return all results, works with -offset and other parameters
.PARAMETER url
URL of Snipeit system, can be set using Set-SnipeitInfo command
.PARAMETER url
URL of Snipeit system, can be set using Set-SnipeitInfo command
.PARAMETER apiKey
Users API Key for Snipeit, can be set using Set-SnipeitInfo command
.PARAMETER apiKey
Users API Key for Snipeit, can be set using Set-SnipeitInfo command
.EXAMPLE
Get-SnipeitManufacturer -search HP
Search all manufacturers for string HP
.EXAMPLE
Get-SnipeitManufacturer -search HP
Search all manufacturers for string HP
.EXAMPLE
Get-SnipeitManufacturer -id 3
Returns manufacturer with id 3
.EXAMPLE
Get-SnipeitManufacturer -id 3
Returns manufacturer with id 3
#>
function Get-SnipeitManufacturer()
{
Param(

View file

@ -30,7 +30,6 @@ Get-SnipeitSupplier -search MySupplier
Get-SnipeitSupplier -id 2
#>
function Get-SnipeitSupplier()
{
Param(

View file

@ -17,7 +17,7 @@
.PARAMETER username
Username for user
.PARAMETER active
.PARAMETER activated
Can user log in to snipe-it?
.PARAMETER notes

View file

@ -10,12 +10,11 @@ Input string
.EXAMPLE
Get-Content [your-script.ps1] | Update-SnipeitAlias | Out-File [new-script-name.ps1]
Replaces old command from file "your-script.ps1" and creates new script "new-script-name.ps1"
After testing new file you can replace old file with new.
#>
function Update-SnipeitAlias()
{
[CmdletBinding(

View file

@ -34,7 +34,7 @@ Updates user with id 3
## PARAMETERS
### -activated
{{ Fill activated Description }}
Can user log in to snipe-it?
```yaml
Type: Boolean

View file

@ -135,5 +135,5 @@ Updates Model on Snipe-it asset system
Creates a new user
### [Update-SnipeitAlias](Update-SnipeitAlias.md)
{{ Fill in the Synopsis }}
Replaces old SnipeitPS commands with new ones

View file

@ -8,7 +8,7 @@ schema: 2.0.0
# Update-SnipeitAlias
## SYNOPSIS
{{ Fill in the Synopsis }}
Replaces old SnipeitPS commands with new ones
## SYNTAX
@ -17,21 +17,22 @@ Update-SnipeitAlias [-String] <String[]> [-WhatIf] [-Confirm] [<CommonParameters
```
## DESCRIPTION
{{ Fill in the Description }}
Replaces old SnipeitPS commands with new ones
## EXAMPLES
### Example 1
```powershell
PS C:\> {{ Add example code here }}
### EXAMPLE 1
```
Get-Content [your-script.ps1] | Update-SnipeitAlias | Out-File [new-script-name.ps1]
```
{{ Add example description here }}
Replaces old command from file "your-script.ps1" and creates new script "new-script-name.ps1"
After testing new file you can replace old file with new.
## PARAMETERS
### -String
{{ Fill String Description }}
Input string
```yaml
Type: String[]
@ -39,7 +40,7 @@ Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
@ -81,11 +82,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## INPUTS
### System.String[]
## OUTPUTS
### System.Object
## NOTES
## RELATED LINKS

43
docs/about_SnipeitPS.md Normal file
View file

@ -0,0 +1,43 @@
# About SnipeitPS
## about_SnipeitPS
# SHORT DESCRIPTION
Powershell API Wrapper for Snipe-it.
# LONG DESCRIPTION
Collection of tools that makes interacting with Snipe-it api more pleasant.
# EXAMPLES
Prepare connection Snipe-It with
Set-SnipeitInfo -url https://your.site -apikey YourVeryLongApiKey....
To search assets use
Get-SnipeitAsset -search needle
Piping get and new commands results to set commands is supported. Followirg will
set notes for every asset that have model_id 123.
Get-SnipeitAsset -model_id 123 -all | Set-SnipeitAsset
# NOTE
# TROUBLESHOOTING NOTE
{{ Troubleshooting Placeholder - Warns users of bugs}}
{{ Explains behavior that is likely to change with fixes }}
# SEE ALSO
{{ See also placeholder }}
{{ You can also list related articles, blogs, and video URLs. }}
# KEYWORDS
{{List alternate names or titles for this topic that readers might use.}}
- {{ Keyword Placeholder }}
- {{ Keyword Placeholder }}
- {{ Keyword Placeholder }}
- {{ Keyword Placeholder }}