Merge branch 'PetriAsi-get-by-id' into develop

SnipeitPS/Public/Get-Asset.ps1

@@ -5,6 +5,15 @@
 .PARAMETER search
 A text string to search the assets data
 
+.PARAMETER id
+A text string to search the assets data
+
+.PARAMETER asset_tag
+Specify exact asset tag to query
+
+.PARAMETER asset_serial
+Specify exact asset serial to query
+
 .PARAMETER order_number
 Optionally restrict asset results to this order number
 
@@ -55,11 +64,20 @@ Get-Asset -search "myMachine" -url "https://assets.example.com" -token "token...
 
 .EXAMPLE
 Get-Asset -search "myMachine" -url "https://assets.example.com" -token "token..."
+
+.EXAMPLE
+Get-Asset -asset_tag "myAssetTag" -url "https://assets.example.com" -token "token..."
 #>
 function Get-Asset() {
     Param(
         [string]$search,
 
+        [string]$id,
+
+        [string]$asset_tag,
+
+        [string]$asset_serial,
+
         [int]$order_number,
 
         [int]$model_id,
@@ -98,8 +116,36 @@ function Get-Asset() {
 
     $SearchParameter = . Get-ParameterValue
 
+
+    $apiurl = "$url/api/v1/hardware"
+
+    if ($search -and ($asset_tag -or $asset_serial -or $id)) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only one of -search , -asset_tag or -asset_serial parameter"
+    }
+
+    if ($id) {
+       if ( $search -or $asset_serial -or $asset_tag) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only one of -search , -asset_tag or -asset_serial parameter"
+       }
+       $apiurl= "$url/api/v1/hardware/$id"      
+    }
+
+    if ($asset_tag) {
+       if ( $search -or $asset_serial -or $id) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only one of -search , -asset_tag or -asset_serial parameter"
+       }
+       $apiurl= "$url/api/v1/hardware/bytag/$asset_tag"      
+    }
+
+    if ($asset_serial) {
+       if ( $search -or $asset_tag) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only one of-search , -asset_tag or -asset_serial parameter"
+       }
+       $apiurl= "$url/api/v1/hardware/byserial/$asset_serial"      
+    }
+    
     $Parameters = @{
-        Uri           = "$url/api/v1/hardware"
+        Uri           = $apiurl
         Method        = 'Get'
         GetParameters = $SearchParameter
         Token         = $apiKey

SnipeitPS/Public/Get-Category.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Categories
 
+.PARAMETER search
+A text string to search the Categories data
+
+.PARAMETER id
+A id of specific Category
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Category()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-Category()
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/categories"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/categories/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/categories"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Company.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Companies
 
+.PARAMETER search
+A text string to search the Companies data
+
+.PARAMETER id
+A id of specific Company
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Company()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-Company()
 
     $SearchParameter = . Get-ParameterValue
 
+    $apiurl = "$url/api/v1/companies"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/companies/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/companies"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Component.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Components
 
+.PARAMETER search
+A text string to search the Components data
+
+.PARAMETER id
+A id of specific Component
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -20,6 +26,8 @@ function Get-Component() {
     Param(
         [string]$search,
         
+        [string]$id,
+
         [int]$category_id,
 
         [int]$company_id,
@@ -45,8 +53,18 @@ function Get-Component() {
 
     $SearchParameter = . Get-ParameterValue
 
+    $apiurl = "$url/api/v1/components"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/components/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/components"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Department.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Departments
 
+.PARAMETER search
+A text string to search the Departments data
+
+.PARAMETER id
+A id of specific Department
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Department()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -40,8 +48,18 @@ function Get-Department()
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/departments"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/departments/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/departments"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-License.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Licenses
 
+.PARAMETER search
+A text string to search the Licenses data
+
+.PARAMETER id
+A id of specific License
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -20,6 +26,8 @@ function Get-License() {
     Param(
         [string]$search,
 
+        [string]$id,
+
         [string]$name,
 
         [int] $company_id,
@@ -61,8 +69,18 @@ function Get-License() {
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/licenses"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/licenses/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/licenses"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Manufacturer.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Manufacturers
 
+.PARAMETER search
+A text string to search the Manufactures data
+
+.PARAMETER id
+A id of specific Manufactuter
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Manufacturer()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-Manufacturer()
 
     $SearchParameter = . Get-ParameterValue
 
+    $apiurl = "$url/api/v1/manufacturers"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/manufacturers/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/manufacturers"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Model.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Models
 
+.PARAMETER search
+A text string to search the Models data
+
+.PARAMETER id
+A id of specific model
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Model()
     Param(
         [string]$search,
 
+        [int]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,11 +45,21 @@ function Get-Model()
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/models"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/models/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/models"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
-        GetParameters = $SearchParameter
+        #GetParameters = $SearchParameter
     }
 
     $result = Invoke-SnipeitMethod @Parameters

SnipeitPS/Public/Get-SnipeitLocation.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Locations
 
+.PARAMETER search
+A text string to search the Locations data
+
+.PARAMETER id
+A id of specific Location
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-SnipeitLocation()
     Param(
         [string]$search,
         
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-SnipeitLocation()
 
     $SearchParameter = . Get-ParameterValue
 
+    $apiurl = "$url/api/v1/locations"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/locations/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/locations"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Status.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Status Labels
 
+.PARAMETER search
+A text string to search the Status Labels data
+
+.PARAMETER id
+A id of specific Status Label
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Status()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-Status()
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/statuslabels"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/statuslabels/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/statuslabels"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-Supplier.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Suppliers
 
+.PARAMETER search
+A text string to search the Supliers data
+
+.PARAMETER id
+A id of specific Suplier
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -21,6 +27,8 @@ function Get-Supplier()
     Param(
         [string]$search,
 
+        [string]$id,
+
         [ValidateSet("asc", "desc")]
         [string]$order = "desc",
 
@@ -37,8 +45,18 @@ function Get-Supplier()
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/suppliers"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/suppliers/$id"      
+    }
+
     $Parameters = @{
-        Uri           = "$url/api/v1/suppliers"
+        Uri           = $apiurl
         Method        = 'Get'
         Token         = $apiKey
         GetParameters = $SearchParameter

SnipeitPS/Public/Get-User.ps1

@@ -2,6 +2,12 @@
 .SYNOPSIS
 # Gets a list of Snipe-it Users
 
+.PARAMETER search
+A text string to search the User data
+
+.PARAMETER id
+A id of specific User
+
 .PARAMETER url
 URL of Snipeit system, can be set using Set-Info command
 
@@ -19,6 +25,8 @@ function Get-User() {
     Param(
         [string]$search,
         
+        [string]$id,
+
         [int]$company_id,
 
         [int]$location_id,
@@ -43,8 +51,17 @@ function Get-User() {
 
     $SearchParameter = . Get-ParameterValue
     
+    $apiurl = "$url/api/v1/users"
+
+    if ($search -and $id ) {
+         Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
+    }
+    
+    if ($id) {
+       $apiurl= "$url/api/v1/users/$id"      
+    }
     $Parameters = @{
-        Uri           = "$url/api/v1/users"
+        Uri           = $apiurl
         Method        = 'Get'
         GetParameters = $SearchParameter
         Token         = $apiKey

SnipeitPS/Public/Set-SnipeitLocation.ps1

@@ -0,0 +1,102 @@
+<#
+    .SYNOPSIS
+    Updates Location in Snipe-it asset system
+
+    .DESCRIPTION
+    Long description
+
+    .PARAMETER name
+    Name of Location
+
+    .PARAMETER address
+    Address line 1
+
+    .PARAMETER address2
+    Address line 2
+
+    .PARAMETER state
+    Address State
+
+    .PARAMETER country
+    Address Contry
+
+    .PARAMETER zip
+    Address zipcode
+
+    .PARAMETER state
+    Address State
+
+    .PARAMETER manager_id
+    Location manager as id
+
+    .PARAMETER ldap_ou
+    LDAP OU of Location
+
+    .PARAMETER parent_id
+    Parent location as id
+
+    .PARAMETER url
+    URL of Snipeit system, can be set using Set-Info command
+
+    .PARAMETER apiKey
+    Users API Key for Snipeit, can be set using Set-Info command
+
+    .EXAMPLE
+    Set-SnipeitLocation -id 123 -name "Some storage"  -parent_id 100
+
+  
+#>
+function Set-SnipeitLocation() {
+    [CmdletBinding(
+        SupportsShouldProcess = $true,
+        ConfirmImpact = "Low"
+    )]
+
+    Param(
+        [parameter(mandatory = $true)]
+        [int]$id,
+
+        [ValidateLength(3, 255)]
+        [string]$name,
+
+        [string]$address,
+
+        [string]$address2,
+
+        [string]$state,
+
+        [string]$country,
+
+        [string]$zip,
+
+        [int]$manager_id,
+
+        [string]$ldap_ou,
+
+        [int]$parent_id,
+
+        [parameter(mandatory = $true)]
+        [string]$url,
+
+        [parameter(mandatory = $true)]
+        [string]$apiKey
+    )
+
+    $Values = . Get-ParameterValue
+
+    $Body = $Values | ConvertTo-Json;
+
+    $Parameters = @{
+        Uri    = "$url/api/v1/locations/$id"
+        Method = 'PUT'
+        Body   = $Body
+        Token  = $apiKey
+    }
+
+    If ($PSCmdlet.ShouldProcess("ShouldProcess?")) {
+        $result = Invoke-SnipeitMethod @Parameters
+    }
+
+    $result
+}
+