mirror of
https://github.com/benclaussen/NetboxPS.git
synced 2025-12-13 01:42:28 +00:00
cfb53cf933
* Add `OPTIONS` method validation * Remove parameter validation as workaround for CHOICES API endpoint until further testing * Add help block for Get-NetboxTenant * SkipConnectedCheck for Get-NetboxAPIDefinition * Correct help block for New-NetboxIPAMAddress * Add parameter position 0 for 'Address' in Get-NetboxIPAMAddress * Allow pipeline input for Address parameter in New-NetboxIPAMAddress * Update parameter types * Add parameter sets and logic for ID/Query searches * Add Get-NetboxDCIMSite * Update psproj * Update deploy.ps1 * Move Get-NetboxCircuit * Add Circuit cmdlets - New-NetboxCircuit - Get-NetboxCircuitProvider - Get-NetboxCircuitTermination - Get-NetboxCircuitType * Update deploy script output path * Update Set-NetboxIPAMAddress - Replace Interface parameter with Assigned_Object_Type and Assigned_Object_Id - Add validation logic for Assigned_Object_ parameters - Change Status parameter to string * Add Get-ModelDefinition function * Update psproj * Update deploy.ps1 variables * Update exported files * Remove references to `_choices` API calls * Add Postman collection * Add Postman collection * Update deploy.ps1 * Add Set-NetboxIPAMPrefix function * Increment version to 1.3.0 Co-authored-by: Ben Claussen <claussen@neonet.org>
121 lines
No EOL
3.4 KiB
PowerShell
121 lines
No EOL
3.4 KiB
PowerShell
<#
|
|
.NOTES
|
|
===========================================================================
|
|
Created with: SAPIEN Technologies, Inc., PowerShell Studio 2020 v5.7.172
|
|
Created on: 3/19/2020 11:56
|
|
Created by: Claussen
|
|
Organization: NEOnet
|
|
Filename: Get-NetboxTenant.ps1
|
|
===========================================================================
|
|
.DESCRIPTION
|
|
A description of the file.
|
|
#>
|
|
|
|
|
|
function Get-NetboxTenant {
|
|
<#
|
|
.SYNOPSIS
|
|
Get a tenent from Netbox
|
|
|
|
.DESCRIPTION
|
|
A detailed description of the Get-NetboxTenant function.
|
|
|
|
.PARAMETER Name
|
|
The specific name of the tenant. Must match exactly as is defined in Netbox
|
|
|
|
.PARAMETER Id
|
|
The database ID of the tenant
|
|
|
|
.PARAMETER Query
|
|
A standard search query that will match one or more tenants.
|
|
|
|
.PARAMETER Slug
|
|
The specific slug of the tenant. Must match exactly as is defined in Netbox
|
|
|
|
.PARAMETER Group
|
|
The specific group as defined in Netbox.
|
|
|
|
.PARAMETER GroupID
|
|
The database ID of the group in Netbox
|
|
|
|
.PARAMETER CustomFields
|
|
Hashtable in the format @{"field_name" = "value"} to search
|
|
|
|
.PARAMETER Limit
|
|
Limit the number of results to this number
|
|
|
|
.PARAMETER Offset
|
|
Start the search at this index in results
|
|
|
|
.PARAMETER Raw
|
|
Return the unparsed data from the HTTP request
|
|
|
|
.EXAMPLE
|
|
PS C:\> Get-NetboxTenant
|
|
|
|
.NOTES
|
|
Additional information about the function.
|
|
#>
|
|
|
|
[CmdletBinding(DefaultParameterSetName = 'Query')]
|
|
param
|
|
(
|
|
[Parameter(ParameterSetName = 'Query',
|
|
Position = 0)]
|
|
[string]$Name,
|
|
|
|
[Parameter(ParameterSetName = 'ByID')]
|
|
[uint32[]]$Id,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[string]$Query,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[string]$Slug,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[string]$Group,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[uint16]$GroupID,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[hashtable]$CustomFields,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[uint16]$Limit,
|
|
|
|
[Parameter(ParameterSetName = 'Query')]
|
|
[uint16]$Offset,
|
|
|
|
[switch]$Raw
|
|
)
|
|
|
|
switch ($PSCmdlet.ParameterSetName) {
|
|
'ById' {
|
|
foreach ($Tenant_ID in $Id) {
|
|
$Segments = [System.Collections.ArrayList]::new(@('tenancy', 'tenants', $Tenant_ID))
|
|
|
|
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters -SkipParameterByName 'Id'
|
|
|
|
$uri = BuildNewURI -Segments $URIComponents.Segments -Parameters $URIComponents.Parameters
|
|
|
|
InvokeNetboxRequest -URI $uri -Raw:$Raw
|
|
}
|
|
|
|
break
|
|
}
|
|
|
|
default {
|
|
$Segments = [System.Collections.ArrayList]::new(@('tenancy', 'tenants'))
|
|
|
|
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters
|
|
|
|
$uri = BuildNewURI -Segments $URIComponents.Segments -Parameters $URIComponents.Parameters
|
|
|
|
InvokeNetboxRequest -URI $uri -Raw:$Raw
|
|
|
|
break
|
|
}
|
|
}
|
|
} |