ansible-later/env_27/lib/python2.7/site-packages/ansible/modules/windows/win_route.ps1
2019-04-11 13:00:36 +02:00

105 lines
2.8 KiB
PowerShell

#!powershell
# Copyright: (c) 2016, Daniele Lazzari <lazzari@mailup.com>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
#Requires -Module Ansible.ModuleUtils.Legacy
# win_route (Add or remove a network static route)
$params = Parse-Args $args -supports_check_mode $true
$check_mode = Get-AnsibleParam -obj $params -name "_ansible_check_mode" -default $false
$dest = Get-AnsibleParam -obj $params -name "destination" -type "str" -failifempty $true
$gateway = Get-AnsibleParam -obj $params -name "gateway" -type "str"
$metric = Get-AnsibleParam -obj $params -name "metric" -type "int" -default 1
$state = Get-AnsibleParam -obj $params -name "state" -type "str" -default "present" -validateSet "present","absent"
$result = @{
"changed" = $false
"output" = ""
}
Function Add-Route {
Param (
[Parameter(Mandatory=$true)]
[string]$Destination,
[Parameter(Mandatory=$true)]
[string]$Gateway,
[Parameter(Mandatory=$true)]
[int]$Metric,
[Parameter(Mandatory=$true)]
[bool]$CheckMode
)
$IpAddress = $Destination.split('/')[0]
# Check if the static route is already present
$Route = Get-CimInstance win32_ip4PersistedrouteTable -Filter "Destination = '$($IpAddress)'"
if (!($Route)){
try {
# Find Interface Index
$InterfaceIndex = Find-NetRoute -RemoteIPAddress $IpAddress | Select -First 1 -ExpandProperty InterfaceIndex
# Add network route
New-NetRoute -DestinationPrefix $Destination -NextHop $Gateway -InterfaceIndex $InterfaceIndex -RouteMetric $Metric -ErrorAction Stop -WhatIf:$CheckMode|out-null
$result.changed = $true
$result.output = "Route added"
}
catch {
$ErrorMessage = $_.Exception.Message
Fail-Json $result $ErrorMessage
}
}
else {
$result.output = "Static route already exists"
}
}
Function Remove-Route {
Param (
[Parameter(Mandatory=$true)]
[string]$Destination,
[bool]$CheckMode
)
$IpAddress = $Destination.split('/')[0]
$Route = Get-CimInstance win32_ip4PersistedrouteTable -Filter "Destination = '$($IpAddress)'"
if ($Route){
try {
Remove-NetRoute -DestinationPrefix $Destination -Confirm:$false -ErrorAction Stop -WhatIf:$CheckMode
$result.changed = $true
$result.output = "Route removed"
}
catch {
$ErrorMessage = $_.Exception.Message
Fail-Json $result $ErrorMessage
}
}
else {
$result.output = "No route to remove"
}
}
# Set gateway if null
if(!($gateway)){
$gateway = "0.0.0.0"
}
if ($state -eq "present"){
Add-Route -Destination $dest -Gateway $gateway -Metric $metric -CheckMode $check_mode
}
else {
Remove-Route -Destination $dest -CheckMode $check_mode
}
Exit-Json $result