#!powershell # (c) 2016, Dag Wieers # # This file is part of Ansible # # Ansible is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # Ansible is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Ansible. If not, see . # WANT_JSON # POWERSHELL_COMMON # Based on: http://powershellblogger.com/2016/01/create-shortcuts-lnk-or-url-files-with-powershell/ $ErrorActionPreference = "Stop" $params = Parse-Args $args -supports_check_mode $true $check_mode = Get-AnsibleParam -obj $params -name "_ansible_check_mode" -type "bool" -default $false $src = Get-AnsibleParam -obj $params -name "src" -type "path" $dest = Get-AnsibleParam -obj $params -name "dest" -type "path" -failifempty $true $state = Get-AnsibleParam -obj $params -name "state" -type "string" -default "present" -validateset "present","absent" $orig_args = Get-AnsibleParam -obj $params -name "args" -type "string" $directory = Get-AnsibleParam -obj $params -name "directory" -type "path" $hotkey = Get-AnsibleParam -obj $params -name "hotkey" -type "string" $icon = Get-AnsibleParam -obj $params -name "icon" -type "path" $orig_description = Get-AnsibleParam -obj $params -name "description" -type "string" $windowstyle = Get-AnsibleParam -obj $params -name "windowstyle" -type "string" -validateset "normal","maximized","minimized" # Expand environment variables on non-path types $args = Expand-Environment($orig_args) $description = Expand-Environment($orig_description) $result = @{ changed = $false dest = $dest state = $state } # Convert from window style name to window style id $windowstyles = @{ normal = 1 maximized = 3 minimized = 7 } # Convert from window style id to window style name $windowstyleids = @( "", "normal", "", "maximized", "", "", "", "minimized" ) If ($state -eq "absent") { If (Test-Path -Path $dest) { # If the shortcut exists, try to remove it Try { Remove-Item -Path $dest -WhatIf:$check_mode } Catch { # Report removal failure Fail-Json $result "Failed to remove shortcut $dest. (" + $_.Exception.Message + ")" } # Report removal success $result.changed = $true } Else { # Nothing to report, everything is fine already } } ElseIf ($state -eq "present") { # Create an in-memory object based on the existing shortcut (if any) $Shell = New-Object -ComObject ("WScript.Shell") $ShortCut = $Shell.CreateShortcut($dest) # Compare existing values with new values, report as changed if required If ($src -ne $null) { # Windows translates executables to absolute path, so do we If (Get-Command -Name $src -Type Application -ErrorAction SilentlyContinue) { $src = (Get-Command -Name $src -Type Application).Definition } } If ($src -ne $null -and $ShortCut.TargetPath -ne $src) { $result.changed = $true $ShortCut.TargetPath = $src } $result.src = $ShortCut.TargetPath # Determine if we have a WshShortcut or WshUrlShortcut by checking the Arguments property # A WshUrlShortcut objects only consists of a TargetPath property If (Get-Member -InputObject $ShortCut -Name Arguments) { # This is a full-featured application shortcut ! If ($orig_args -ne $null -and $ShortCut.Arguments -ne $args) { $result.changed = $true $ShortCut.Arguments = $args } $result.args = $ShortCut.Arguments If ($directory -ne $null -and $ShortCut.WorkingDirectory -ne $directory) { $result.changed = $true $ShortCut.WorkingDirectory = $directory } $result.directory = $ShortCut.WorkingDirectory # FIXME: Not all values are accepted here ! Improve docs too. If ($hotkey -ne $null -and $ShortCut.Hotkey -ne $hotkey) { $result.changed = $true $ShortCut.Hotkey = $hotkey } $result.hotkey = $ShortCut.Hotkey If ($icon -ne $null -and $ShortCut.IconLocation -ne $icon) { $result.changed = $true $ShortCut.IconLocation = $icon } $result.icon = $ShortCut.IconLocation If ($orig_description -ne $null -and $ShortCut.Description -ne $description) { $result.changed = $true $ShortCut.Description = $description } $result.description = $ShortCut.Description If ($windowstyle -ne $null -and $ShortCut.WindowStyle -ne $windowstyles.$windowstyle) { $result.changed = $true $ShortCut.WindowStyle = $windowstyles.$windowstyle } $result.windowstyle = $windowstyleids[$ShortCut.WindowStyle] } If ($result.changed -eq $true -and $check_mode -ne $true) { Try { $ShortCut.Save() } Catch { Fail-Json $result "Failed to create shortcut $dest. (" + $_.Exception.Message + ")" } } } Exit-Json $result