diff --git a/CHANGELOG.md b/CHANGELOG.md index 8c9c881..04526e5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## Unreleased - Update module for current PowerShell +## [1.1.2.1] - 2020-09-15 +### Updated +- Issue #59 Change plural functions to singular + +### Removed +- Issue #39 Remove functions not relevant to this module + ## [1.1.2.0] - 2020-09-14 ### Removed - Issue #55 Remove New-ScheduledTask diff --git a/ComputerManagement/ComputerManagement.psd1 b/ComputerManagement/ComputerManagement.psd1 index 65928b5..d2d1440 100644 --- a/ComputerManagement/ComputerManagement.psd1 +++ b/ComputerManagement/ComputerManagement.psd1 @@ -12,7 +12,7 @@ RootModule = 'ComputerManagement.psm1' # Version number of this module. -ModuleVersion = '1.1.2.0' +ModuleVersion = '1.1.2.1' # Supported PSEditions # CompatiblePSEditions = @() @@ -69,13 +69,13 @@ Description = 'A PowerShell module for working with the local computer' # NestedModules = @() # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export. -FunctionsToExport = 'Set-Pass', 'Get-CimService', 'Get-NonStandardServiceAccount', - 'Get-PendingUpdates', 'Get-ServiceTag', 'Backup-EventLogs', - 'Export-EventLog', 'Get-PaperCutLogs', 'Set-ShutdownMethod', - 'Get-PrinterLogs', 'Get-OpenSessions', 'Get-OpenFiles', - 'Get-RDPLoginEvents', 'Get-InvalidLogonAttempts', 'Get-MappedDrives', - 'Get-DiskUsage', 'Get-Namespace', 'New-Password', 'Connect-Rdp', - 'Get-NetShare', 'Get-WinEventTail', 'Open-CdDrive', +FunctionsToExport = 'Set-Pass', 'Get-CimService', 'Get-NonStandardServiceAccount', + 'Get-PendingUpdates', 'Get-ServiceTag', 'Backup-EventLogs', + 'Export-EventLog', 'Get-PaperCutLogs', 'Set-ShutdownMethod', + 'Get-PrinterLogs', 'Get-OpenSessions', 'Get-OpenFiles', + 'Get-RDPLoginEvents', 'Get-InvalidLogonAttempts', 'Get-MappedDrives', + 'Get-DiskUsage', 'Get-Namespace', 'New-Password', 'Connect-Rdp', + 'Get-NetShare', 'Get-WinEventTail', 'Open-CdDrive', 'Grant-RegistryPermission', 'New-Credential' # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export. @@ -120,7 +120,7 @@ PrivateData = @{ # ExternalModuleDependencies = '' } # End of PSData hashtable - + } # End of PrivateData hashtable # HelpInfo URI of this module diff --git a/ComputerManagement/ComputerManagement.psm1 b/ComputerManagement/ComputerManagement.psm1 index 3be25bf..ea282f6 100644 --- a/ComputerManagement/ComputerManagement.psm1 +++ b/ComputerManagement/ComputerManagement.psm1 @@ -1,62 +1,3 @@ -Function Set-Pass { - [OutputType([System.String])] - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-Pass.md#set-pass', - SupportsShouldProcess, - ConfirmImpact = 'Low')] - Param - ( - [Parameter(Mandatory = $true)] - [string]$ComputerName, - [Parameter(Mandatory = $true)] - [string]$UserName, - [Parameter(Mandatory = $true)] - [securestring]$Password - ) - Begin { - } - Process { - Try { - if ($PSCmdlet.ShouldProcess("Change", "Change password for $($UserName)")) { - $User = [adsi]("WinNT://$ComputerName/$UserName, user") - $User.psbase.invoke("SetPassword", ($Password | ConvertFrom-SecureString -AsPlainText)) - - Return "Password updated" - } - } - Catch { - Return $Error[0].Exception.InnerException.Message.ToString().Trim() - } - } - End { - } -} -Function Get-CimService { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-CimService.md#get-cimservice')] - Param - ( - [string]$Computer = (& hostname), - [pscredential]$Credential, - [string]$State = "Running", - [string]$StartMode = "Auto" - ) - Begin { - } - Process { - If ($Computer -eq (& hostname)) { - $Services = Get-CimInstance -ClassName Win32_Service -Filter "State = '$State' and StartMode = '$StartMode'" - } - Else { - If ($null -eq $Credential) { - $Credential = Get-Credential - } - $Services = Get-CimInstance -ClassName Win32_Service -Filter "State = '$State' and StartMode = '$StartMode'" ` - -ComputerName $Computer -Credential $Credential - } - } - End { - Return $Services - } -} Function Get-NonStandardServiceAccount { [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-NonStandardServiceAccount.md#get-nonstandardserviceaccount')] Param @@ -90,8 +31,8 @@ Function Get-NonStandardServiceAccount { Return $Suspect } } -Function Get-PendingUpdates { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdates.md#get-pendingupdates')] +Function Get-PendingUpdate { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdate.md#get-pendingupdate')] Param ( [Parameter(ValueFromPipeline = $True)] @@ -148,8 +89,8 @@ Function Get-ServiceTag { Return $Return } } -Function Backup-EventLogs { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLogs.md#backup-eventlogs')] +Function Backup-EventLog { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLog.md#backup-eventlog')] Param ( [string]$ComputerName, @@ -251,85 +192,8 @@ Function Export-EventLog { End { } } -Function Get-PaperCutLogs { - [OutputType([Object[]])] - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PaperCutLogs.md#get-papercutlogs')] - Param - ( - $PrintServers = @("ps1.company.com", "ps2.company.com") - ) - Begin { - # Location of the monthly PaperCut logs - $PcutLogLocation = "c$\Program Files (x86)\PaperCut Print Logger\logs\csv\monthly" - # Column headings in the CSV - $PcutHeader = "Time", "User", "Pages", "Copies", "Printer", "Document Name", "Client", "Paper Size", "Language", "Height", "Width", "Duplex", "Grayscale", "Size" - # Need it set to stop in order for the try/catch to work - $ErrorActionPreference = "Stop" - # Define an empty array to hold all the log entries - $PcutReport = @() - } - Process { - foreach ($PrintServer in $PrintServers) { - # Get each log file from the server - Try { - $PcutLogs = Get-ChildItem "\\$($PrintServer)\$($PcutLogLocation)" - } - Catch { - # This runs only if we're trying to pull logs from an x86 print server - $PcutLogs = Get-ChildItem "\\$($PrintServer)\c$\Program Files\PaperCut Print Logger\logs\csv\monthly" - } - - Foreach ($PcutLog in $PcutLogs) { - # Import the csv into a variable, skip 1 skips the first line of the PaperCut CSV - # which has information not related to the log itself - $ThisReport = Import-Csv $PcutLog.FullName -Header $PcutHeader | Select-Object -Skip 1 - - # Add this log to the array - $PcutReport += $ThisReport | Where-Object { $_.Time -ne "Time" } - } - } - } - End { - # Display the result, this can be piped into Export-CSV to generate a large - # spreadsheet suitable for analysis - Return $PcutReport - } -} -Function Set-ShutdownMethod { - [OutputType([System.String])] - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-ShutdownMethod.md#set-shutdownmethod', - SupportsShouldProcess, - ConfirmImpact = 'High')] - PARAM - ( - [parameter(Mandatory = $True, ValueFromPipeline = $True)] - [string]$ComputerName, - [pscredential]$Credentials = (Get-Credential), - [int32]$ShutdownMethod = 0 - ) - Begin { - } - Process { - Try { - if ($PSCmdlet.ShouldProcess("Shutdown", "Shutdown $($ComputerName)")) { - $ReturnValue = (Get-CimInstance -Class Win32_OperatingSystem -ComputerName $ComputerName -Credential $Credentials).InvokeMethod("Win32Shutdown", $ShutdownMethod) - } - } - Catch { - $ReturnValue = $Error[0] - } - } - End { - if ($ReturnValue -ne 0) { - Return "An error occurred, most likely there is nobody logged into $($ComputerName)" - } - else { - Return "Success" - } - } -} -Function Get-PrinterLogs { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLogs.md#get-printerlogs')] +Function Get-PrinterLog { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLog.md#get-printerlog')] Param ( $LogName = "Microsoft-Windows-PrintService/Operational", @@ -373,8 +237,8 @@ Function Get-PrinterLogs { Return $PrintLogs } } -Function Get-OpenSessions { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSessions.md#get-opensessions')] +Function Get-OpenSession { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSession.md#get-opensession')] Param ( $ComputerName = (hostname) @@ -404,8 +268,8 @@ Function Get-OpenSessions { Return $ServerSessions } } -Function Get-OpenFiles { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFiles.md#get-openfiles')] +Function Get-OpenFile { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFile.md#get-openfile')] Param ( $ComputerName = (hostname) @@ -434,9 +298,9 @@ Function Get-OpenFiles { Return $OpenFiles } } -Function Get-RDPLoginEvents { +Function Get-RDPLoginEvent { [OutputType([Object[]])] - [cmdletbinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvents.md#Get-rdploginevents')] + [cmdletbinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvent.md#Get-rdploginevent')] Param ( [Parameter(ValueFromPipeline = $true, Mandatory = $true)] @@ -479,8 +343,8 @@ Function Get-RDPLoginEvents { Return $LoginAttempts } } -Function Get-InvalidLogonAttempts { - [cmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempts.md#get-invalidlogonattempts')] +Function Get-InvalidLogonAttempt { + [cmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempt.md#get-invalidlogonattempt')] Param ( [Parameter(ValueFromPipeline = $true, Mandatory = $true)] @@ -515,8 +379,8 @@ Function Get-InvalidLogonAttempts { Return $Report } } -Function Get-MappedDrives { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrives.md#get-mappeddrives')] +Function Get-MappedDrive { + [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrive.md#get-mappeddrive')] Param ( [string]$ComputerName = (hostname), @@ -589,30 +453,6 @@ Function Get-DiskUsage { End { } } -Function Get-Namespace { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-Namespace.md#get-namespace')] - Param - ( - [parameter(Mandatory = $true, ValueFromPipeline = $true)] - [string]$Namespace, - [parameter(Mandatory = $true)] - [string]$ComputerName - ) - Begin { - Write-Verbose 'Create an SWbemLocator object to connect to the computer' - $WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator" - Write-Verbose "Make a connection to $($ComputerName) and access $($Namespace)" - $WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace) - Write-Verbose "Use the SubClassesOf() method of the SWbemServices object to return an SWbemObjectSet" - $WbemObjectSet = $WbemServices.SubclassesOf() - } - Process { - } - End { - Write-Verbose 'Return the Path_ property of the ObjectSet as this seems to contain useful information' - Return $WbemObjectSet | Select-Object -Property Path_ -ExpandProperty Path_ - } -} Function New-Password { [OutputType([System.Object[]])] [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/New-Password.md#new-password', @@ -762,35 +602,6 @@ Function Get-WinEventTail { End { } } -function Open-CdDrive { - [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Open-CdDrive.md#open-cddrive')] - param - ( - [string]$Drive - ) - Begin { - $sApplication = new-object -com Shell.Application - $MyComputer = 17 - } - Process { - if ($Drive) { - $Cdrom = $sApplication.Namespace(17).ParseName($Drive) - $Cdrom.InvokeVerb("Eject") - $Cdrom - } - else { - $Cdrom = $sApplication.NameSpace($MyComputer).Items() | Where-Object -Property Type -eq 'CD Drive' - foreach ($Cd in $Cdrom) { - $Cd.InvokeVerb('Eject') - $cd - } - } - } - end { - [System.Runtime.Interopservices.Marshal]::ReleaseComObject($sApplication) | Out-Null - Remove-Variable sApplication - } -} Function Grant-RegistryPermission { [CmdletBinding(HelpURI = 'https://github.com/mod-posh/ComputerManagement/blob/master/docs/Grant-RegistryPermission.md#grant-registrypermission')] Param diff --git a/ComputerManagement/en-us/ComputerManagement-help.xml b/ComputerManagement/en-us/ComputerManagement-help.xml index 409bc57..9017143 100644 --- a/ComputerManagement/en-us/ComputerManagement-help.xml +++ b/ComputerManagement/en-us/ComputerManagement-help.xml @@ -2,9 +2,9 @@ - Backup-EventLogs + Backup-EventLog Backup - EventLogs + EventLog Backup Eventlogs from remote computer @@ -14,7 +14,7 @@ - Backup-EventLogs + Backup-EventLog ComputerName @@ -110,7 +110,7 @@ Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLogs.md#backup-eventlogs + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLog.md#backup-eventlog @@ -408,205 +408,6 @@ Media Center - - - Get-CimService - Get - CimService - - Get a list of services - - - - This function returns a list of services on a given computer. This list can be filtered based on the given StartMode (ie. Running, Stopped) as well as filtered on StartMode (ie. Auto, Manual). - - - - Get-CimService - - Computer - - The NetBIOS name of the computer to retrieve services from - - String - - String - - - (& hostname) - - - Credential - - The DOMAIN\USERNAME of an account with permissions to access services. - - PSCredential - - PSCredential - - - None - - - State - - Most often this will be either Running or Stopped, but possible values include Running Stopped Paused - - String - - String - - - Running - - - StartMode - - Most often this will be either Auto or Manual, but possible values include Auto Manual Disabled - - String - - String - - - Auto - - - - - - Computer - - The NetBIOS name of the computer to retrieve services from - - String - - String - - - (& hostname) - - - Credential - - The DOMAIN\USERNAME of an account with permissions to access services. - - PSCredential - - PSCredential - - - None - - - StartMode - - Most often this will be either Auto or Manual, but possible values include Auto Manual Disabled - - String - - String - - - Auto - - - State - - Most often this will be either Running or Stopped, but possible values include Running Stopped Paused - - String - - String - - - Running - - - - - - - Depending on how you are setup you may need to provide credentials in order to access remote machines You may need to have UAC disabled or run PowerShell as an administrator to see services locally - - - - - -------------------------- EXAMPLE 1 -------------------------- - Get-CimService |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 atashost 1380 Auto Running OK - 0 AudioEndpointBuilder 920 Auto Running OK - 0 AudioSrv 880 Auto Running OK - 0 BFE 1236 Auto Running OK - 0 BITS 964 Auto Running OK - 0 CcmExec 2308 Auto Running OK - 0 CryptSvc 1088 Auto Running OK - - This example shows the default options in place - - - - -------------------------- EXAMPLE 2 -------------------------- - Get-CimService -State "stopped" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 AppHostSvc 0 Auto Stopped OK - 0 clr_optimization_v4.0.30319_32 0 Auto Stopped OK - 0 clr_optimization_v4.0.30319_64 0 Auto Stopped OK - 0 MMCSS 0 Auto Stopped OK - 0 Net Driver HPZ12 0 Auto Stopped OK - 0 Pml Driver HPZ12 0 Auto Stopped OK - 0 sppsvc 0 Auto Stopped OK - - This example shows the output when specifying the state parameter - - - - -------------------------- EXAMPLE 3 -------------------------- - Get-CimService -State "stopped" -StartMode "disabled" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 1077 clr_optimization_v2.0.50727_32 0 Disabled Stopped OK - 1077 clr_optimization_v2.0.50727_64 0 Disabled Stopped OK - 1077 CscService 0 Disabled Stopped OK - 1077 Mcx2Svc 0 Disabled Stopped OK - 1077 MSSQLServerADHelper100 0 Disabled Stopped OK - 1077 NetMsmqActivator 0 Disabled Stopped OK - 1077 NetPipeActivator 0 Disabled Stopped OK - - This example shows how to specify a different state and startmode. - - - - -------------------------- EXAMPLE 4 -------------------------- - Get-CimService -Computer dpm -Credential "Domain\Administrator" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 AppHostSvc 1152 Auto Running OK - 0 BFE 564 Auto Running OK - 0 CryptSvc 1016 Auto Running OK - 0 DcomLaunch 600 Auto Running OK - 0 Dhcp 776 Auto Running OK - 0 Dnscache 1016 Auto Running OK - 0 DPMAMService 1184 Auto Running OK - - This example shows how to specify a remote computer and credentials to authenticate with. - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/get-cimservice.md#get-cimservice - - - Get-DiskUsage @@ -715,9 +516,9 @@ C:\Windows 18163345365 - Get-InvalidLogonAttempts + Get-InvalidLogonAttempt Get - InvalidLogonAttempts + InvalidLogonAttempt Return a list of invalid logon attempts. @@ -727,7 +528,7 @@ C:\Windows 18163345365 - Get-InvalidLogonAttempts + Get-InvalidLogonAttempt ComputerName @@ -844,15 +645,15 @@ An account ... Desktop-pc1... 10/26/2011... ##.###.###... 10 Daniel Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempts.md#get-invalidlogonattempts + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempt.md#get-invalidlogonattempt - Get-MappedDrives + Get-MappedDrive Get - MappedDrives + MappedDrive Return a list of mapped network drives on the computer @@ -862,7 +663,7 @@ An account ... Desktop-pc1... 10/26/2011... ##.###.###... 10 Daniel - Get-MappedDrives + Get-MappedDrive ComputerName @@ -955,129 +756,7 @@ VolumeName : IGroup Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrives.md#get-mappeddrives - - - - - - Get-Namespace - Get - Namespace - - Return a collection of classes from a namespace - - - - This function will return a collection of classes from the provided namespace. This method uses SWbemLocator to connect to a computer, the resulting SWbemServices object is used to return the SubclassesOf() the given namespace. - - - - Get-Namespace - - Namespace - - The WMI namespace to enumerate - - String - - String - - - None - - - ComputerName - - The computer to connect to - - String - - String - - - None - - - - - - ComputerName - - The computer to connect to - - String - - String - - - None - - - Namespace - - The WMI namespace to enumerate - - String - - String - - - None - - - - - - - FunctionName : Get-Namespace Created by : jspatton Date Coded : 05/21/2012 12:50:50 - - - - - -------------------------- EXAMPLE 1 -------------------------- - Get-Namespace -Namespace 'root\ccm' -ComputerName 'sccm' - -Path : \\\\SCCM\ROOT\ccm:__NAMESPACE -RelPath : __NAMESPACE -Server : SCCM -Namespace : ROOT\ccm -ParentNamespace : ROOT -DisplayName : WINMGMTS:{authenticationLevel=pkt,impersonationLevel=impersonate}!\\\\SCCM\ROOT\ccm:__NAMESPACE -Class : __NAMESPACE -IsClass : True -IsSingleton : False -Keys : System.__ComObject -Security_ : System.__ComObject -Locale : -Authority : - - A simple example showing usage and output of the command. - - - - -------------------------- EXAMPLE 2 -------------------------- - Get-Namespace -Namespace $NameSpace -ComputerName $ComputerName |Select-Object -Property Class - -Class ------ -__SystemClass -__thisNAMESPACE -__NAMESPACE -__Provider -__Win32Provider -__ProviderRegistration -__EventProviderRegistration -__EventConsumerProviderRegistration - - This example shows piping the output of the Get-Namespace function to Select-Object to return one of the properties of a class. - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-Namespace.md#get-namespace + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrive.md#get-mappeddrive @@ -1329,9 +1008,9 @@ StartName Name DisplayName - Get-OpenFiles + Get-OpenFile Get - OpenFiles + OpenFile Get a list of files open on the server @@ -1341,7 +1020,7 @@ StartName Name DisplayName - Get-OpenFiles + Get-OpenFile ComputerName @@ -1394,15 +1073,15 @@ User2 P:\Public 0 Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFiles.md#get-openfiles + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFile.md#get-openfile - Get-OpenSessions + Get-OpenSession Get - OpenSessions + OpenSession Return a list of open sessions @@ -1412,7 +1091,7 @@ User2 P:\Public 0 - Get-OpenSessions + Get-OpenSession ComputerName @@ -1465,33 +1144,33 @@ user2 10.10.1.156 7529 17 Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSessions.md#get-opensessions + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSession.md#get-opensession - Get-PaperCutLogs + Get-PendingUpdate Get - PaperCutLogs + PendingUpdate - Get PaperCut logs from all print servers + Retrieves the updates waiting to be installed from WSUS - Return the PaperCut logs from all print servers. + Retrieves the updates that are available to install on the local system - Get-PaperCutLogs - - PrintServers + Get-PendingUpdate + + ComputerName - The FQDN of the print servers + Computer or computers to find updates for. - Object + String - Object + String None @@ -1499,107 +1178,21 @@ user2 10.10.1.156 7529 17 - - PrintServers + + ComputerName - The FQDN of the print servers + Computer or computers to find updates for. - Object + String - Object + String None - - - - None - - - You must have downlaoded and installed the latest version of PaperCut Print Logger for this to work. - http://www.papercut.com/products/free_software/print_logger/# - The resulting data will encompass all months that the servers have been logging data for, currently this goes back about 3 years. The CSV output can be opened in Excel and you can generate graphs based on which printer is used the most, how much paper is consumed by each printer and so on. - - - - - - - System.Object[] - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - PS C:\> Get-PaperCutLogs |Export-Csv -Path .\PrintLog.csv - - This example shows the basic usage of the command. The output is piped into a spreadsheet on the local computer for further analysis. - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PaperCutLogs.md#get-papercutlogs - - - - - - Get-PendingUpdates - Get - PendingUpdates - - Retrieves the updates waiting to be installed from WSUS - - - - Retrieves the updates that are available to install on the local system - - - - Get-PendingUpdates - - ComputerName - - Computer or computers to find updates for. - - String - - String - - - None - - - - - - ComputerName - - Computer or computers to find updates for. - - String - - String - - - None - - - - + + Author: Boe Prox Date Created: 05Mar2011 RPC Dynamic Ports need to be enabled on inbound remote servers. @@ -1617,15 +1210,15 @@ user2 10.10.1.156 7529 17 Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdates.md#get-pendingupdates + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdate.md#get-pendingupdate - Get-PrinterLogs + Get-PrinterLog Get - PrinterLogs + PrinterLog Get a log of all printing from a given server. @@ -1635,7 +1228,7 @@ user2 10.10.1.156 7529 17 - Get-PrinterLogs + Get-PrinterLog LogName @@ -1724,15 +1317,15 @@ Document : Microsoft Office Outlook - Memo Style Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLogs.md#get-printerlogs + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLog.md#get-printerlog - Get-RDPLoginEvents + Get-RDPLoginEvent Get - RDPLoginEvents + RDPLoginEvent Return Remote Desktop login attempts @@ -1742,7 +1335,7 @@ Document : Microsoft Office Outlook - Memo Style - Get-RDPLoginEvents + Get-RDPLoginEvent ComputerName @@ -1840,7 +1433,7 @@ SourceNetworkAddress Domain TimeCreated User Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvents.md#Get-rdploginevents + https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvent.md#Get-rdploginevent @@ -2603,472 +2196,4 @@ tXkFwY_pe(VIFf$R2^bKyKy)D_H6q^Nz7MgSDylXrV2GIkyiFVnvfbd9KENFuHQz - - - Open-CdDrive - Open - CdDrive - - A function to eject the CD Drive - - - - This function uses the shell.application comObject to eject one or more CD rom drives. I had the need to eject several CDroms from servers and wanted an easier way to do it. I found a sample in the Technet gallery (see link) and modified to suite my needs. - - - - Open-CdDrive - - Drive - - If present it will eject the drive corresponding to the drive letter - - String - - String - - - None - - - - - - Drive - - If present it will eject the drive corresponding to the drive letter - - String - - String - - - None - - - - - - - FunctionName : Open-CdDrive Created by : Jeffrey Date Coded : 01/10/2015 08:33:30 - - - - - -------------------------- EXAMPLE 1 -------------------------- - Open-CdDrive - -Application : System.__ComObject -Parent : System.__ComObject -Name : DVD RW Drive (E:) -Path : E:\ -GetLink : -GetFolder : System.__ComObject -IsLink : False -IsFolder : True -IsFileSystem : True -IsBrowsable : False -ModifyDate : 12/30/1899 12:00:00 AM -Size : 0 -Type : CD Drive - - This example shows how to eject any cdrom on the system - - - - -------------------------- EXAMPLE 2 -------------------------- - Open-CdDrive -Drive E: - -Application : System.__ComObject -Parent : System.__ComObject -Name : DVD RW Drive (E:) -Path : E:\ -GetLink : -GetFolder : System.__ComObject -IsLink : False -IsFolder : True -IsFileSystem : True -IsBrowsable : False -ModifyDate : 12/30/1899 12:00:00 AM -Size : 0 -Type : CD Drive - - This example shows how to eject the CD labled E: from the system - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Open-CdDrive.md#open-cddrive - - - Technet Gallery - https://gallery.technet.microsoft.com/scriptcenter/7d81af29-1cae-4dbb-8027-cd96a985f311 - - - - - - Set-Pass - Set - Pass - - Change the password of an existing user account. - - - - This function will change the password for an existing user account. - - - - Set-Pass - - ComputerName - - The NetBIOS name of the computer that you will add the account to. - - String - - String - - - None - - - UserName - - The user name of the account that will be created. - - String - - String - - - None - - - Password - - The password for the account, this must follow password policies enforced on the destination computer. - - SecureString - - SecureString - - - None - - - Confirm - - Prompts you for confirmation before running the cmdlet. - - - SwitchParameter - - - False - - - WhatIf - - Shows what would happen if the cmdlet runs. The cmdlet is not run. - - - SwitchParameter - - - False - - - - - - ComputerName - - The NetBIOS name of the computer that you will add the account to. - - String - - String - - - None - - - Password - - The password for the account, this must follow password policies enforced on the destination computer. - - SecureString - - SecureString - - - None - - - UserName - - The user name of the account that will be created. - - String - - String - - - None - - - Confirm - - Prompts you for confirmation before running the cmdlet. - - SwitchParameter - - SwitchParameter - - - False - - - WhatIf - - Shows what would happen if the cmdlet runs. The cmdlet is not run. - - SwitchParameter - - SwitchParameter - - - False - - - - - - None - - - - - - - - - - System.String - - - - - - - - - You will need to run this with either UAC disabled or from an elevated prompt. - - - - - -------------------------- Example 1 -------------------------- - PS C:\> Set-Pass -ComputerName MyComputer -UserName MyUserAccount -Password N3wP@ssw0rd - - This shows using the function against a remote computer - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-Pass.md#set-pass - - - - - - Set-ShutdownMethod - Set - ShutdownMethod - - Execute the Win32Shutdown method on a remote computer - - - - This function executes the Win32Shutdown method on a remote computer. This can be either an IP, NetBIOS name or FQDN. Use the ShutdownMethod param to specify the type of shutdown. - - - - Set-ShutdownMethod - - ComputerName - - The IP, NetBIOS or FQDN of the remote computer. - - String - - String - - - None - - - Credentials - - A user account with the ability to retreive these events. - - PSCredential - - PSCredential - - - None - - - ShutdownMethod - - Win32Shutdown accepts one of the following in32's 0 = Logoff (Default) 1 = Shutdown 2 = Reboot 4 = Force Logoff (Doesn't work) 8 = PowerOff - - Int32 - - Int32 - - - None - - - Confirm - - Prompts you for confirmation before running the cmdlet. - - - SwitchParameter - - - False - - - WhatIf - - Shows what would happen if the cmdlet runs. The cmdlet is not run. - - - SwitchParameter - - - False - - - - - - ComputerName - - The IP, NetBIOS or FQDN of the remote computer. - - String - - String - - - None - - - Credentials - - A user account with the ability to retreive these events. - - PSCredential - - PSCredential - - - None - - - ShutdownMethod - - Win32Shutdown accepts one of the following in32's 0 = Logoff (Default) 1 = Shutdown 2 = Reboot 4 = Force Logoff (Doesn't work) 8 = PowerOff - - Int32 - - Int32 - - - None - - - Confirm - - Prompts you for confirmation before running the cmdlet. - - SwitchParameter - - SwitchParameter - - - False - - - WhatIf - - Shows what would happen if the cmdlet runs. The cmdlet is not run. - - SwitchParameter - - SwitchParameter - - - False - - - - - - System.String - - - - - - - - - - System.String - - - - - - - - - You will need proper credentials on the remote machine for this to work. - - - - - -------------------------- Example 1 -------------------------- - PS C:\> Set-ShutdownMethod -ComputerName Desktop-pc01 - - This is the default syntax for this command - - - - -------------------------- Example 2 -------------------------- - PS C:\> Set-ShutdownMethod -ComputerName Desktop-pc01 -ShutdownMethod 0 - - This shows how to use the optional parameter ShutdownMethod - - - - - - Online Version: - https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-ShutdownMethod.md#set-shutdownmethod - - - \ No newline at end of file diff --git a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_HelpInfo.xml b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_HelpInfo.xml index 15763fb..f70214c 100644 --- a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_HelpInfo.xml +++ b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_HelpInfo.xml @@ -4,7 +4,7 @@ en-US - 1.1.2.0 + 1.1.2.1 \ No newline at end of file diff --git a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.cab b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.cab index e0066bf..3f58527 100644 Binary files a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.cab and b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.cab differ diff --git a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.zip b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.zip index 6eee88f..711debc 100644 Binary files a/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.zip and b/cabs/ComputerManagement_9c9c5339-5b88-4f63-a664-d9bf90b7ed3a_en-US_HelpContent.zip differ diff --git a/docs/Backup-EventLogs.md b/docs/Backup-EventLog.md similarity index 96% rename from docs/Backup-EventLogs.md rename to docs/Backup-EventLog.md index a0accb9..aeea467 100644 --- a/docs/Backup-EventLogs.md +++ b/docs/Backup-EventLog.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLogs.md#backup-eventlogs +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Backup-EventLog.md#backup-eventlog schema: 2.0.0 --- -# Backup-EventLogs +# Backup-EventLog ## SYNOPSIS Backup Eventlogs from remote computer diff --git a/docs/ComputerManagement.md b/docs/ComputerManagement.md index 13cc0a2..92b0266 100644 --- a/docs/ComputerManagement.md +++ b/docs/ComputerManagement.md @@ -2,7 +2,7 @@ Module Name: ComputerManagement Module Guid: 9c9c5339-5b88-4f63-a664-d9bf90b7ed3a Download Help Link: https://raw.githubusercontent.com/mod-posh/ComputerManagement/master/cabs/ -Help Version: 1.1.2.0 +Help Version: 1.1.2.1 Locale: en-US --- @@ -11,7 +11,7 @@ Locale: en-US This is a collection of functions I used to work with computers ## ComputerManagement Cmdlets -### [Backup-EventLogs](Backup-EventLogs.md) +### [Backup-EventLog](Backup-EventLog.md) Backup Eventlogs from remote computer ### [Connect-Rdp](Connect-Rdp.md) @@ -20,43 +20,34 @@ Connect to one or more computers over RDP ### [Export-EventLog](Export-EventLog.md) Export an Eventlog from a local or remote computer -### [Get-CimService](Get-CimService.md) -Get a list of services - ### [Get-DiskUsage](Get-DiskUsage.md) Get the disk usage of a given path -### [Get-InvalidLogonAttempts](Get-InvalidLogonAttempts.md) +### [Get-InvalidLogonAttempt](Get-InvalidLogonAttempt.md) Return a list of invalid logon attempts. -### [Get-MappedDrives](Get-MappedDrives.md) +### [Get-MappedDrive](Get-MappedDrive.md) Return a list of mapped network drives on the computer -### [Get-Namespace](Get-Namespace.md) -Return a collection of classes from a namespace - ### [Get-NetShare](Get-NetShare.md) Return a list of shares without using WMI ### [Get-NonStandardServiceAccount](Get-NonStandardServiceAccount.md) Return a list of services using Non-Standard accounts. -### [Get-OpenFiles](Get-OpenFiles.md) +### [Get-OpenFile](Get-OpenFile.md) Get a list of files open on the server -### [Get-OpenSessions](Get-OpenSessions.md) +### [Get-OpenSession](Get-OpenSession.md) Return a list of open sessions -### [Get-PaperCutLogs](Get-PaperCutLogs.md) -Get PaperCut logs from all print servers - -### [Get-PendingUpdates](Get-PendingUpdates.md) +### [Get-PendingUpdate](Get-PendingUpdate.md) Retrieves the updates waiting to be installed from WSUS -### [Get-PrinterLogs](Get-PrinterLogs.md) +### [Get-PrinterLog](Get-PrinterLog.md) Get a log of all printing from a given server. -### [Get-RDPLoginEvents](Get-RDPLoginEvents.md) +### [Get-RDPLoginEvent](Get-RDPLoginEvent.md) Return Remote Desktop login attempts ### [Get-ServiceTag](Get-ServiceTag.md) @@ -72,14 +63,4 @@ Grant permissions on registry paths Create a Credential Object ### [New-Password](New-Password.md) -Create a new password - -### [Open-CdDrive](Open-CdDrive.md) -A function to eject the CD Drive - -### [Set-Pass](Set-Pass.md) -Change the password of an existing user account. - -### [Set-ShutdownMethod](Set-ShutdownMethod.md) -Execute the Win32Shutdown method on a remote computer - +Create a new password \ No newline at end of file diff --git a/docs/Get-CimService.md b/docs/Get-CimService.md deleted file mode 100644 index 05f7f78..0000000 --- a/docs/Get-CimService.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/get-cimservice.md#get-cimservice -schema: 2.0.0 ---- - -# Get-CimService - -## SYNOPSIS -Get a list of services - -## SYNTAX - -``` -Get-CimService [[-Computer] ] [[-Credential] ] [[-State] ] - [[-StartMode] ] [] -``` - -## DESCRIPTION -This function returns a list of services on a given computer. This list can be -filtered based on the given StartMode (ie. Running, Stopped) as well as -filtered on StartMode (ie. Auto, Manual). - -## EXAMPLES - -### EXAMPLE 1 -``` -Get-CimService |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 atashost 1380 Auto Running OK - 0 AudioEndpointBuilder 920 Auto Running OK - 0 AudioSrv 880 Auto Running OK - 0 BFE 1236 Auto Running OK - 0 BITS 964 Auto Running OK - 0 CcmExec 2308 Auto Running OK - 0 CryptSvc 1088 Auto Running OK -``` - -This example shows the default options in place - -### EXAMPLE 2 -``` -Get-CimService -State "stopped" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 AppHostSvc 0 Auto Stopped OK - 0 clr_optimization_v4.0.30319_32 0 Auto Stopped OK - 0 clr_optimization_v4.0.30319_64 0 Auto Stopped OK - 0 MMCSS 0 Auto Stopped OK - 0 Net Driver HPZ12 0 Auto Stopped OK - 0 Pml Driver HPZ12 0 Auto Stopped OK - 0 sppsvc 0 Auto Stopped OK -``` - -This example shows the output when specifying the state parameter - -### EXAMPLE 3 -``` -Get-CimService -State "stopped" -StartMode "disabled" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 1077 clr_optimization_v2.0.50727_32 0 Disabled Stopped OK - 1077 clr_optimization_v2.0.50727_64 0 Disabled Stopped OK - 1077 CscService 0 Disabled Stopped OK - 1077 Mcx2Svc 0 Disabled Stopped OK - 1077 MSSQLServerADHelper100 0 Disabled Stopped OK - 1077 NetMsmqActivator 0 Disabled Stopped OK - 1077 NetPipeActivator 0 Disabled Stopped OK -``` - -This example shows how to specify a different state and startmode. - -### EXAMPLE 4 -``` -Get-CimService -Computer dpm -Credential "Domain\Administrator" |Format-Table -AutoSize - -ExitCode Name ProcessId StartMode State Status --------- ---- --------- --------- ----- ------ - 0 AppHostSvc 1152 Auto Running OK - 0 BFE 564 Auto Running OK - 0 CryptSvc 1016 Auto Running OK - 0 DcomLaunch 600 Auto Running OK - 0 Dhcp 776 Auto Running OK - 0 Dnscache 1016 Auto Running OK - 0 DPMAMService 1184 Auto Running OK -``` - -This example shows how to specify a remote computer and credentials to authenticate with. - -## PARAMETERS - -### -Computer -The NetBIOS name of the computer to retrieve services from - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: False -Position: 1 -Default value: (& hostname) -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Credential -The DOMAIN\USERNAME of an account with permissions to access services. - -```yaml -Type: PSCredential -Parameter Sets: (All) -Aliases: - -Required: False -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -StartMode -Most often this will be either Auto or Manual, but possible values include - Auto - Manual - Disabled - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: False -Position: 4 -Default value: Auto -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -State -Most often this will be either Running or Stopped, but possible values include - Running - Stopped - Paused - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: False -Position: 3 -Default value: Running -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -## OUTPUTS - -## NOTES -Depending on how you are setup you may need to provide credentials in order to access remote machines -You may need to have UAC disabled or run PowerShell as an administrator to see services locally - -## RELATED LINKS diff --git a/docs/Get-InvalidLogonAttempts.md b/docs/Get-InvalidLogonAttempt.md similarity index 97% rename from docs/Get-InvalidLogonAttempts.md rename to docs/Get-InvalidLogonAttempt.md index 6b52079..6a43199 100644 --- a/docs/Get-InvalidLogonAttempts.md +++ b/docs/Get-InvalidLogonAttempt.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempts.md#get-invalidlogonattempts +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-InvalidLogonAttempt.md#get-invalidlogonattempt schema: 2.0.0 --- -# Get-InvalidLogonAttempts +# Get-InvalidLogonAttempt ## SYNOPSIS Return a list of invalid logon attempts. diff --git a/docs/Get-MappedDrives.md b/docs/Get-MappedDrive.md similarity index 96% rename from docs/Get-MappedDrives.md rename to docs/Get-MappedDrive.md index 40cd5d7..306227d 100644 --- a/docs/Get-MappedDrives.md +++ b/docs/Get-MappedDrive.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrives.md#get-mappeddrives +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-MappedDrive.md#get-mappeddrive schema: 2.0.0 --- -# Get-MappedDrives +# Get-MappedDrive ## SYNOPSIS Return a list of mapped network drives on the computer diff --git a/docs/Get-Namespace.md b/docs/Get-Namespace.md deleted file mode 100644 index c7b4072..0000000 --- a/docs/Get-Namespace.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-Namespace.md#get-namespace -schema: 2.0.0 ---- - -# Get-Namespace - -## SYNOPSIS -Return a collection of classes from a namespace - -## SYNTAX - -``` -Get-Namespace [-Namespace] [-ComputerName] [] -``` - -## DESCRIPTION -This function will return a collection of classes from the provided namespace. -This method uses SWbemLocator to connect to a computer, the resulting -SWbemServices object is used to return the SubclassesOf() the given namespace. - -## EXAMPLES - -### EXAMPLE 1 -``` -Get-Namespace -Namespace 'root\ccm' -ComputerName 'sccm' - -Path : \\\\SCCM\ROOT\ccm:__NAMESPACE -RelPath : __NAMESPACE -Server : SCCM -Namespace : ROOT\ccm -ParentNamespace : ROOT -DisplayName : WINMGMTS:{authenticationLevel=pkt,impersonationLevel=impersonate}!\\\\SCCM\ROOT\ccm:__NAMESPACE -Class : __NAMESPACE -IsClass : True -IsSingleton : False -Keys : System.__ComObject -Security_ : System.__ComObject -Locale : -Authority : -``` - -A simple example showing usage and output of the command. - -### EXAMPLE 2 -``` -Get-Namespace -Namespace $NameSpace -ComputerName $ComputerName |Select-Object -Property Class - -Class ------ -__SystemClass -__thisNAMESPACE -__NAMESPACE -__Provider -__Win32Provider -__ProviderRegistration -__EventProviderRegistration -__EventConsumerProviderRegistration -``` - -This example shows piping the output of the Get-Namespace function to Select-Object to return -one of the properties of a class. - -## PARAMETERS - -### -ComputerName -The computer to connect to - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Namespace -The WMI namespace to enumerate - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: 1 -Default value: None -Accept pipeline input: True (ByValue) -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -## OUTPUTS - -## NOTES -FunctionName : Get-Namespace -Created by : jspatton -Date Coded : 05/21/2012 12:50:50 - -## RELATED LINKS diff --git a/docs/Get-OpenFiles.md b/docs/Get-OpenFile.md similarity index 96% rename from docs/Get-OpenFiles.md rename to docs/Get-OpenFile.md index fe1c2ac..ab1a039 100644 --- a/docs/Get-OpenFiles.md +++ b/docs/Get-OpenFile.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFiles.md#get-openfiles +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenFile.md#get-openfile schema: 2.0.0 --- -# Get-OpenFiles +# Get-OpenFile ## SYNOPSIS Get a list of files open on the server diff --git a/docs/Get-OpenSessions.md b/docs/Get-OpenSession.md similarity index 95% rename from docs/Get-OpenSessions.md rename to docs/Get-OpenSession.md index 73c0ee8..b0e99c6 100644 --- a/docs/Get-OpenSessions.md +++ b/docs/Get-OpenSession.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSessions.md#get-opensessions +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-OpenSession.md#get-opensession schema: 2.0.0 --- -# Get-OpenSessions +# Get-OpenSession ## SYNOPSIS Return a list of open sessions diff --git a/docs/Get-PaperCutLogs.md b/docs/Get-PaperCutLogs.md deleted file mode 100644 index b867a2a..0000000 --- a/docs/Get-PaperCutLogs.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PaperCutLogs.md#get-papercutlogs -schema: 2.0.0 ---- - -# Get-PaperCutLogs - -## SYNOPSIS -Get PaperCut logs from all print servers - -## SYNTAX - -``` -Get-PaperCutLogs [[-PrintServers] ] [] -``` - -## DESCRIPTION -Return the PaperCut logs from all print servers. - -## EXAMPLES - -### Example 1 -```powershell -PS C:\> Get-PaperCutLogs |Export-Csv -Path .\PrintLog.csv -``` - -This example shows the basic usage of the command. The output is piped into -a spreadsheet on the local computer for further analysis. - -## PARAMETERS - -### -PrintServers -The FQDN of the print servers - -```yaml -Type: Object -Parameter Sets: (All) -Aliases: - -Required: False -Position: 0 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -### None -You must have downlaoded and installed the latest version of PaperCut Print Logger for this to work. - -http://www.papercut.com/products/free_software/print_logger/# - -The resulting data will encompass all months that the servers have been logging data for, currently this goes back about 3 years. The CSV output can be opened in Excel and you can generate graphs based on which printer is used the most, how much paper is consumed by each printer and so on. - -## OUTPUTS - -### System.Object[] -## NOTES - -## RELATED LINKS diff --git a/docs/Get-PendingUpdates.md b/docs/Get-PendingUpdate.md similarity index 93% rename from docs/Get-PendingUpdates.md rename to docs/Get-PendingUpdate.md index 59c034d..7e18c18 100644 --- a/docs/Get-PendingUpdates.md +++ b/docs/Get-PendingUpdate.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdates.md#get-pendingupdates +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PendingUpdate.md#get-pendingupdate schema: 2.0.0 --- -# Get-PendingUpdates +# Get-PendingUpdate ## SYNOPSIS Retrieves the updates waiting to be installed from WSUS diff --git a/docs/Get-PrinterLogs.md b/docs/Get-PrinterLog.md similarity index 96% rename from docs/Get-PrinterLogs.md rename to docs/Get-PrinterLog.md index bb59186..fb82d65 100644 --- a/docs/Get-PrinterLogs.md +++ b/docs/Get-PrinterLog.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLogs.md#get-printerlogs +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-PrinterLog.md#get-printerlog schema: 2.0.0 --- -# Get-PrinterLogs +# Get-PrinterLog ## SYNOPSIS Get a log of all printing from a given server. diff --git a/docs/Get-RDPLoginEvents.md b/docs/Get-RDPLoginEvent.md similarity index 97% rename from docs/Get-RDPLoginEvents.md rename to docs/Get-RDPLoginEvent.md index 3743d6b..69bce48 100644 --- a/docs/Get-RDPLoginEvents.md +++ b/docs/Get-RDPLoginEvent.md @@ -1,11 +1,11 @@ --- external help file: ComputerManagement-help.xml Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvents.md#Get-rdploginevents +online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Get-RDPLoginEvent.md#Get-rdploginevent schema: 2.0.0 --- -# Get-RDPLoginEvents +# Get-RDPLoginEvent ## SYNOPSIS Return Remote Desktop login attempts diff --git a/docs/Open-CdDrive.md b/docs/Open-CdDrive.md deleted file mode 100644 index 7502224..0000000 --- a/docs/Open-CdDrive.md +++ /dev/null @@ -1,104 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Open-CdDrive.md#open-cddrive -schema: 2.0.0 ---- - -# Open-CdDrive - -## SYNOPSIS -A function to eject the CD Drive - -## SYNTAX - -``` -Open-CdDrive [[-Drive] ] [] -``` - -## DESCRIPTION -This function uses the shell.application comObject to -eject one or more CD rom drives. -I had the need to eject several CDroms -from servers and wanted an easier way to do it. -I found a sample -in the Technet gallery (see link) and modified to suite my -needs. - -## EXAMPLES - -### EXAMPLE 1 -``` -Open-CdDrive - -Application : System.__ComObject -Parent : System.__ComObject -Name : DVD RW Drive (E:) -Path : E:\ -GetLink : -GetFolder : System.__ComObject -IsLink : False -IsFolder : True -IsFileSystem : True -IsBrowsable : False -ModifyDate : 12/30/1899 12:00:00 AM -Size : 0 -Type : CD Drive -``` - -This example shows how to eject any cdrom on the system - -### EXAMPLE 2 -``` -Open-CdDrive -Drive E: - -Application : System.__ComObject -Parent : System.__ComObject -Name : DVD RW Drive (E:) -Path : E:\ -GetLink : -GetFolder : System.__ComObject -IsLink : False -IsFolder : True -IsFileSystem : True -IsBrowsable : False -ModifyDate : 12/30/1899 12:00:00 AM -Size : 0 -Type : CD Drive -``` - -This example shows how to eject the CD labled E: from the system - -## PARAMETERS - -### -Drive -If present it will eject the drive corresponding to the drive letter - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -## OUTPUTS - -## NOTES -FunctionName : Open-CdDrive -Created by : Jeffrey -Date Coded : 01/10/2015 08:33:30 - -## RELATED LINKS - -[Technet Gallery](https://gallery.technet.microsoft.com/scriptcenter/7d81af29-1cae-4dbb-8027-cd96a985f311) - diff --git a/docs/Set-Pass.md b/docs/Set-Pass.md deleted file mode 100644 index f4736a0..0000000 --- a/docs/Set-Pass.md +++ /dev/null @@ -1,123 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-Pass.md#set-pass -schema: 2.0.0 ---- - -# Set-Pass - -## SYNOPSIS -Change the password of an existing user account. - -## SYNTAX - -``` -Set-Pass [-ComputerName] [-UserName] [-Password] [-WhatIf] [-Confirm] - [] -``` - -## DESCRIPTION -This function will change the password for an existing user account. - -## EXAMPLES - -### Example 1 -```powershell -PS C:\> Set-Pass -ComputerName MyComputer -UserName MyUserAccount -Password N3wP@ssw0rd -``` - -This shows using the function against a remote computer - -## PARAMETERS - -### -ComputerName -The NetBIOS name of the computer that you will add the account to. - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: 0 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Password -The password for the account, this must follow password policies enforced on the -destination computer. - -```yaml -Type: SecureString -Parameter Sets: (All) -Aliases: - -Required: True -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -UserName -The user name of the account that will be created. - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Confirm -Prompts you for confirmation before running the cmdlet. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: cf - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: wi - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -### None -## OUTPUTS - -### System.String -## NOTES -You will need to run this with either UAC disabled or from an elevated prompt. - -## RELATED LINKS diff --git a/docs/Set-ShutdownMethod.md b/docs/Set-ShutdownMethod.md deleted file mode 100644 index c83564d..0000000 --- a/docs/Set-ShutdownMethod.md +++ /dev/null @@ -1,136 +0,0 @@ ---- -external help file: ComputerManagement-help.xml -Module Name: ComputerManagement -online version: https://github.com/mod-posh/ComputerManagement/blob/master/docs/Set-ShutdownMethod.md#set-shutdownmethod -schema: 2.0.0 ---- - -# Set-ShutdownMethod - -## SYNOPSIS -Execute the Win32Shutdown method on a remote computer - -## SYNTAX - -``` -Set-ShutdownMethod [-ComputerName] [[-Credentials] ] [[-ShutdownMethod] ] - [-WhatIf] [-Confirm] [] -``` - -## DESCRIPTION -This function executes the Win32Shutdown method on a remote computer. This can -be either an IP, NetBIOS name or FQDN. Use the ShutdownMethod param to specify -the type of shutdown. - -## EXAMPLES - -### Example 1 -```powershell -PS C:\> Set-ShutdownMethod -ComputerName Desktop-pc01 -``` - -This is the default syntax for this command - -### Example 2 -```powershell -PS C:\> Set-ShutdownMethod -ComputerName Desktop-pc01 -ShutdownMethod 0 -``` - -This shows how to use the optional parameter ShutdownMethod - -## PARAMETERS - -### -ComputerName -The IP, NetBIOS or FQDN of the remote computer. - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: 0 -Default value: None -Accept pipeline input: True (ByValue) -Accept wildcard characters: False -``` - -### -Credentials -A user account with the ability to retreive these events. - -```yaml -Type: PSCredential -Parameter Sets: (All) -Aliases: - -Required: False -Position: 1 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -ShutdownMethod -Win32Shutdown accepts one of the following in32's - 0 = Logoff (Default) - 1 = Shutdown - 2 = Reboot - 4 = Force Logoff (Doesn't work) - 8 = PowerOff - -```yaml -Type: Int32 -Parameter Sets: (All) -Aliases: - -Required: False -Position: 2 -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Confirm -Prompts you for confirmation before running the cmdlet. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: cf - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. - -```yaml -Type: SwitchParameter -Parameter Sets: (All) -Aliases: wi - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). - -## INPUTS - -### System.String -## OUTPUTS - -### System.String -## NOTES -You will need proper credentials on the remote machine for this to work. - -## RELATED LINKS