dips/NetboxPS
1
0
Fork 0
mirror of https://github.com/benclaussen/NetboxPS.git synced 2025-12-15 02:35:46 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge branch 'master' into dev

Browse source 
# Conflicts:
#	Functions/IPAM/Address/Get-NetboxIPAMAddress.ps1
#	Functions/IPAM/Address/New-NetboxIPAMAddress.ps1
#	Functions/IPAM/Address/Remove-NetboxIPAMAddress.ps1
#	Functions/IPAM/Address/Set-NetboxIPAMAddress.ps1
This commit is contained in:
Ben Claussen 2021-03-30 10:58:08 -04:00
commit 5fc0a8e9fa
7 changed files with 168 additions and 155 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
Functions/IPAM/Address/Get-NetboxIPAMAddress.ps1
View file

@ -3,7 +3,7 @@
param
(
[Parameter(ParameterSetName = 'Query',
Position = 0)]
Position = 0)]
[string]$Address,
[Parameter(ParameterSetName = 'ByID')]

18
Functions/IPAM/Address/Get-NetboxIPAMAvailableIP.ps1
View file

@ -13,7 +13,7 @@
function Get-NetboxIPAMAvailableIP {
<#
<#
.SYNOPSIS
A convenience method for returning available IP addresses within a prefix
@ -44,21 +44,23 @@ function Get-NetboxIPAMAvailableIP {
param
(
[Parameter(Mandatory = $true,
ValueFromPipelineByPropertyName = $true)]
ValueFromPipelineByPropertyName = $true)]
[Alias('Id')]
[uint16]$Prefix_ID,
[int]$Prefix_ID,
[Alias('NumberOfIPs')]
[uint16]$Limit,
[int]$Limit,
[switch]$Raw
)
$Segments = [System.Collections.ArrayList]::new(@('ipam', 'prefixes', $Prefix_ID, 'available-ips'))
process {
$Segments = [System.Collections.ArrayList]::new(@('ipam', 'prefixes', $Prefix_ID, 'available-ips'))
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters -SkipParameterByName 'prefix_id'
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters -SkipParameterByName 'prefix_id'
$uri = BuildNewURI -Segments $URIComponents.Segments -Parameters $URIComponents.Parameters
$uri = BuildNewURI -Segments $URIComponents.Segments -Parameters $URIComponents.Parameters
InvokeNetboxRequest -URI $uri -Raw:$Raw
InvokeNetboxRequest -URI $uri -Raw:$Raw
}
}

55
Functions/IPAM/Address/New-NetboxIPAMAddress.ps1
View file

@ -13,7 +13,7 @@
function New-NetboxIPAMAddress {
<#
<#
.SYNOPSIS
Create a new IP address to Netbox
@ -47,6 +47,9 @@ function New-NetboxIPAMAddress {
.PARAMETER Description
Description of IP address
.PARAMETER Dns_name
DNS Name of IP address (example : netbox.example.com)
.PARAMETER Force
Do not prompt for confirmation to create IP.
@ -61,55 +64,59 @@ function New-NetboxIPAMAddress {
#>
[CmdletBinding(ConfirmImpact = 'Low',
SupportsShouldProcess = $true)]
SupportsShouldProcess = $true)]
[OutputType([pscustomobject])]
param
(
[Parameter(Mandatory = $true,
ValueFromPipelineByPropertyName = $true)]
ValueFromPipelineByPropertyName = $true)]
[string]$Address,
[object]$Status = 'Active',
[uint16]$Tenant,
[int]$Tenant,
[uint16]$VRF,
[int]$VRF,
[object]$Role,
[uint16]$NAT_Inside,
[int]$NAT_Inside,
[hashtable]$Custom_Fields,
[uint16]$Interface,
[int]$Interface,
[string]$Description,
[string]$Dns_name,
[switch]$Force,
[switch]$Raw
)
$Segments = [System.Collections.ArrayList]::new(@('ipam', 'ip-addresses'))
$Method = 'POST'
process {
$Segments = [System.Collections.ArrayList]::new(@('ipam', 'ip-addresses'))
$Method = 'POST'
# # Value validation
# $ModelDefinition = GetModelDefinitionFromURIPath -Segments $Segments -Method $Method
# $EnumProperties = GetModelEnumProperties -ModelDefinition $ModelDefinition
#
# foreach ($Property in $EnumProperties.Keys) {
# if ($PSBoundParameters.ContainsKey($Property)) {
# Write-Verbose "Validating property [$Property] with value [$($PSBoundParameters.$Property)]"
# $PSBoundParameters.$Property = ValidateValue -ModelDefinition $ModelDefinition -Property $Property -ProvidedValue $PSBoundParameters.$Property
# }
# }
#
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters
# # Value validation
# $ModelDefinition = GetModelDefinitionFromURIPath -Segments $Segments -Method $Method
# $EnumProperties = GetModelEnumProperties -ModelDefinition $ModelDefinition
#
# foreach ($Property in $EnumProperties.Keys) {
# if ($PSBoundParameters.ContainsKey($Property)) {
# Write-Verbose "Validating property [$Property] with value [$($PSBoundParameters.$Property)]"
# $PSBoundParameters.$Property = ValidateValue -ModelDefinition $ModelDefinition -Property $Property -ProvidedValue $PSBoundParameters.$Property
# }
# }
#
$URIComponents = BuildURIComponents -URISegments $Segments -ParametersDictionary $PSBoundParameters
$URI = BuildNewURI -Segments $URIComponents.Segments
$URI = BuildNewURI -Segments $URIComponents.Segments
if ($Force -or $PSCmdlet.ShouldProcess($Address, 'Create new IP address')) {
InvokeNetboxRequest -URI $URI -Method $Method -Body $URIComponents.Parameters -Raw:$Raw
if ($Force -or $PSCmdlet.ShouldProcess($Address, 'Create new IP address')) {
InvokeNetboxRequest -URI $URI -Method $Method -Body $URIComponents.Parameters -Raw:$Raw
}
}
}

8
Functions/IPAM/Address/Remove-NetboxIPAMAddress.ps1
View file

@ -12,7 +12,7 @@
#>
function Remove-NetboxIPAMAddress {
<#
<#
.SYNOPSIS
Remove an IP address from Netbox
@ -33,12 +33,12 @@ function Remove-NetboxIPAMAddress {
#>
[CmdletBinding(ConfirmImpact = 'High',
SupportsShouldProcess = $true)]
SupportsShouldProcess = $true)]
param
(
[Parameter(Mandatory = $true,
ValueFromPipelineByPropertyName = $true)]
[uint16[]]$Id,
ValueFromPipelineByPropertyName = $true)]
[int[]]$Id,
[switch]$Force
)

17
Functions/IPAM/Address/Set-NetboxIPAMAddress.ps1
View file

@ -14,24 +14,24 @@
function Set-NetboxIPAMAddress {
[CmdletBinding(ConfirmImpact = 'Medium',
SupportsShouldProcess = $true)]
SupportsShouldProcess = $true)]
param
(
[Parameter(Mandatory = $true,
ValueFromPipelineByPropertyName = $true)]
[uint16[]]$Id,
ValueFromPipelineByPropertyName = $true)]
[int[]]$Id,
[string]$Address,
[string]$Status,
[uint16]$Tenant,
[int]$Tenant,
[uint16]$VRF,
[int]$VRF,
[object]$Role,
[uint16]$NAT_Inside,
[int]$NAT_Inside,
[hashtable]$Custom_Fields,
@ -42,6 +42,8 @@ function Set-NetboxIPAMAddress {
[string]$Description,
[string]$Dns_name,
[switch]$Force
)
@ -71,7 +73,8 @@ function Set-NetboxIPAMAddress {
if ($PSBoundParameters.ContainsKey('Assigned_Object_Type') -or $PSBoundParameters.ContainsKey('Assigned_Object_Id')) {
if ((-not [string]::IsNullOrWhiteSpace($Assigned_Object_Id)) -and [string]::IsNullOrWhiteSpace($Assigned_Object_Type)) {
throw "Assigned_Object_Type is required when specifying Assigned_Object_Id"
} elseif ((-not [string]::IsNullOrWhiteSpace($Assigned_Object_Type)) -and [string]::IsNullOrWhiteSpace($Assigned_Object_Id)) {
}
elseif ((-not [string]::IsNullOrWhiteSpace($Assigned_Object_Type)) -and [string]::IsNullOrWhiteSpace($Assigned_Object_Id)) {
throw "Assigned_Object_Id is required when specifying Assigned_Object_Type"
}
}

6
README.md
View file

@ -5,9 +5,9 @@
This module is beta. Use it at your own risk. I have only added functions as I have needed them, so not everything is available.
# Description
This module is a wrapper for the [Netbox](https://github.com/digitalocean/netbox) API.
This module is a wrapper for the [Netbox](https://github.com/netbox-community/netbox) API.
# Usage
1. Install module from the `dist` folder
1. Install module from the `netboxPS` folder
2. Import module
3. Connect to an API endpoint by using `Connect-NetboxAPI`
3. Connect to an API endpoint by using `Connect-NetboxAPI -Hostname netbox.example.com`

1
_config.yml Normal file
View file

@ -0,0 +1 @@
theme: jekyll-theme-slate