public/Remove-OneShortcut.ps1
|
function Remove-OneShortcut { [CmdletBinding(SupportsShouldProcess)] Param( [Parameter(Mandatory = $false)] [string] $ShortcutName, [Parameter(Mandatory = $false)] [string] $UniqueItemId, [Parameter(Mandatory = $true)] [string] $UserPrincipalName ) begin { Write-Verbose "[$(Get-Date)] [BEGIN ] $($MyInvocation.MyCommand)" Write-Verbose "[$(Get-Date)] [CALL ] Test-OneConnection()" if (!(Test-OneConnection)) { Write-Error "[$(Get-Date)] [ERROR ] No connection established. Please use Connect-OneShortcut to create a session." -ErrorAction Stop } } process { $ApiRequest = @{ ApiRequestMethod = [Microsoft.PowerShell.Commands.WebRequestMethod]::Delete } if ($ShortcutName) { $ApiRequest.ApiResource = "drives/$($UserPrincipalName)/root:/$([uri]::EscapeDataString($ShortcutName))" } elseif ($UniqueItemId) { $ApiRequest.ApiResource = "drives/$($UserPrincipalName)/items/$($UniqueItemId)" } else { Write-Error "[$(Get-Date)] [ERROR ] ShortcutName or ItemId required." -ErrorAction Stop } if ($PSCmdlet.ShouldProcess("$($UserPrincipalName)'s OneDrive", "Deleting shortcut '$($ShortcutName)'")) { Write-Verbose "[$(Get-Date)] [CALL ] Invoke-OneApiRequest($($ApiRequest.ApiResource), $($ApiRequest.ApiRequestMethod))" $ApiResponse = (Invoke-OneApiRequest @ApiRequest) return $ApiResponse } } end { Write-Verbose "[$(Get-Date)] [END ] $($MyInvocation.MyCommand)" } } |