FogApi

Author(s)

• JJ Fullmer FOG Project

Tags

fog fogapi imaging provisioning fogproject

Functions

Add-FogHostMac Add-FogResultData Approve-FogPendingMac Deny-FogPendingMac Disable-FogApiHTTPS Dismount-WinEfi Enable-FogApiHTTPS Find-FogObject Get-FogActiveTasks Get-FogGroupAssociations Get-FogGroupByName Get-FogGroups Get-FogHost Get-FogHostAssociatedSnapins Get-FogHostGroup Get-FogHostMacs Get-FogHostPendingMacs Get-FogHosts Get-FogImages Get-FogInventory Get-FogLog Get-FogMacAddresses Get-FogModules Get-FogObject Get-FogScheduledTasks Get-FogSecsSinceEpoch Get-FogServerSettings Get-FogServerSettingsFile Get-FogSetting Get-FogSettings Get-FogSnapinAssociations Get-FogSnapins Get-FogVersion Get-LastImageTime Get-WinBcdPxeID Get-WinEfiMountLetter Install-FogService Invoke-FogApi Mount-WinEfi New-FogHost New-FogObject Receive-FogImage Remove-FogObject Remove-UsbMac Repair-FogSnapinAssociations Reset-HostEncryption Resolve-HostID Send-FogImage Send-FogWolTask Set-FogHostImage Set-FogInventory Set-FogServerSettings Set-FogServerSettingsFileSecurity Set-FogSetting Set-FogSnapins Set-WinToBootToPxe Start-FogSnapin Start-FogSnapins Test-FogVerAbove1dot6 Test-StringNotNullOrEmpty Update-FogObject

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

# 2508.9.23

Fix #41 and add some other user experience improvements (#42)

* Error in send-fogimage command
Fixes #41 When powershell 5.1 is used, invoke-restmethod and invoke-webrequest don't auto change the method from GET to POST when a body exists in the call. Added a check in invoke-fogapi for if body is not null and method is get, when true will change to a POST method.
* Also added a failsafe try/catch in Get-FogScheduledTasks in case this still happens somehow. It will catch if the result is null.
* Also found that active tasks weren't always being force closed with -force. Changed the null/count check for active tasks to ensure they get canceled when -force is used with send-fogimage and ensured that both existing scheduled tasks and active tasks are checked for by separating their if/else branches.

* Minor changes to setting fog settings. Fixing erroneous error when setting the security of the settings file as a standard user, set-acl was displaying an error even though it was being caught and falling back to icacls which works for a standard user. Also changed to using the internal Test-StringNotNullOrEmpty function for null checks when setting settings.

* Add how to download and import a temp version of the dev branch module.

* Add linux compatible dev import in readme.

* Fixed a warning message typo

* Pull help text from default settings file instead of hard coding it so only 1 place to update. Also testing for whitespace in apitokens and server name as a fallback for testing validity. Added a catch for if the fogserver name is specified as just a hostname, it will prepend http:// in this case and display a warning.

* added a timer so linux users can read the warning before the editor opens to manually edit the settings file

* display message about the wait before opening the commandline editor for linux users

* default to vi instead of nano

* added Quick vi/nano edit tips


Full change log history available at https://fogapi.readthedocs.io/en/latest/ReleaseNotes/