Skip to content

Commit ef4f387

Browse files
jdhitsolutionsjdhitsolutions
committed
v2.39.0
2 parents 39cc3b0 + f910a68 commit ef4f387

11 files changed

Lines changed: 1370 additions & 85 deletions

‎Archive-ChangeLog.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@
22

33
This file contains older change history. It is maintained for reference purposes.
44

5+
## v2.34.1
6+
7+
+ Updated `license.txt` with the new year.
8+
+ Added missing online help links.
9+
+ Fixed bug in `Get-ParameterInfo` that failed to display dynamic parameters when using a command alias. ([Issue #101](https://github.com/jdhitsolutions/PSScriptTools/issues/101))
10+
+ Modified format file for `PSParameterInfo` to display `Mandatory` and `IsDynamic` values in color when the value is `$True`.
11+
512
## v2.34.0
613

714
+ Fixed typo bug in `Get-PSScriptTools` that was failing to get command aliases. ([Issue #99](https://github.com/jdhitsolutions/PSScriptTools/issues/99))

‎PSScriptTools.psd1‎

172 Bytes
Binary file not shown.

‎PSScriptToolsManual.pdf‎

191 KB
Binary file not shown.

‎README.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -592,6 +592,61 @@ User Jeff C:\Program Files (x86)\Vale\ True
592592

593593
## File Tools
594594

595+
### [Get-LastModifiedFile](docs/Get-LastModifiedFile.md)
596+
597+
Get files last modified within a certain interval. The default is 24 hours.
598+
599+
```dos
600+
PS C:\> Get-LastModifiedFile -Path c:\work
601+
602+
Directory: C:\work
603+
604+
Mode LastWriteTime Length Name
605+
---- ------------- ------ ----
606+
-a--- 11/30/2021 1:52 PM 2010 a.txt
607+
-a--- 11/30/2021 1:52 PM 5640 b.txt
608+
```
609+
610+
But you can specify other ranges.
611+
612+
```dos
613+
PS C:\> Get-LastModifiedFile -Path c:\scripts -filter *.xml -Interval Months -IntervalCount 6
614+
615+
Directory: C:\Scripts
616+
617+
Mode LastWriteTime Length Name
618+
---- ------------- ------ ----
619+
-a--- 8/31/2021 7:12 PM 17580 DefaultDomainPolicy.xml
620+
-a--- 8/31/2021 7:12 PM 17290 PKIAutoEnroll.xml
621+
-a--- 8/31/2021 8:43 PM 9786 sample-gpo.xml
622+
-a--- 8/31/2021 7:24 PM 50062 TestUser.xml
623+
-a--- 6/22/2021 7:47 PM 4628 vaults.xml
624+
```
625+
626+
You might use this command with other PowerShell commands to get usage statistics.
627+
628+
```dos
629+
PS C:\> Get-LastModifiedFile -Path c:\scripts -Recurse -Interval Years -IntervalCount 1 |
630+
>> Group-Object {$_.LastWriteTime.month} |
631+
>> Select-Object @{Name="Month";Expression = {"{0:MMM}" -f (Get-Date -Month $_.Name)}},
632+
>> Count
633+
634+
Month Count
635+
----- -----
636+
Jan 152
637+
Feb 200
638+
Mar 228
639+
Apr 169
640+
May 106
641+
Jun 92
642+
Jul 86
643+
Aug 112
644+
Sep 109
645+
Oct 136
646+
Nov 225
647+
Dec 216
648+
```
649+
595650
### [Get-FileExtensionInfo](docs/Get-FileExtensionInfo.md)
596651

597652
This command will search a given directory and produce a report of all files based on their file extension. This command is only available in PowerShell 7. The extension with the largest total size will be highlighted in color.

‎Tests/Get-ParameterInfo.tests.ps1‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
#Requires -Module @{ ModuleName = 'Pester'; ModuleVersion = '5.0.0' }
2+
3+
BeforeAll {
4+
Import-Module "$PSScriptRoot/../PSScriptTools.psm1" -Force # -verbose
5+
}
6+
7+
Describe 'Get-ParameterInfo' {
8+
It "Should Not Compare <_>'s -Count Parameter" -ForEach @(
9+
Get-Command 'Get-Random'
10+
# You only need to test one case, it either works, or not.
11+
# The Hard-coded test is a lot faster, I Kept the query to document why Get-Random was chosen.
12+
# Get-Command | Where-Object { $_.Parameters.Keys -contains 'Count' } | Select-Object -First 1
13+
) {
14+
{
15+
Get-Command $_ | Get-ParameterInfo -ea stop
16+
} | Should -Not -Throw -Because 'Key "count" was shadowing the dictionary property'
17+
}
18+
}

‎changelog.md‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
This file contains the most recent change history for the PSScriptTools module.
44

5+
## v2.39.0
6+
7+
+ Updated `Test-WithCulture` to include additional Verbose output.
8+
+ Added command [Get-FileExtensionInfo](docs/Get-FileExtensionInfo.md) with format file `FileExtensionInfo.format.ps1xml'. This command will require PowerShell 7.
9+
+ Added `New-PSDynamicParameter` and `New-PSDynamicParameterForm`.
10+
+ Incorporated pull request [#116](https://github.com/jdhitsolutions/PSScriptTools/pull/116) to fix bug with `Get-ParameterInfo` when the command has a `count` parameter. Thanks @ninmonkey.
11+
+ Added command [Get-LastModifiedFile](docs/Get-LastModifiedFile.md) and its alias *glm*.
12+
+ Help updates.
13+
+ Updated `README.md`.
14+
515
## v2.38.0
616

717
+ Added `Get-PSUnique` function with an alias of `gpsu`. ([Issue #109](https://github.com/jdhitsolutions/PSScriptTools/issues/109)).
@@ -53,12 +63,6 @@ This file contains the most recent change history for the PSScriptTools module.
5363
+ Updated `Get-CommandSyntax` to not use ANSI formatting when running in a non-console host.
5464
+ Updated `README.md`.
5565

56-
## v2.34.1
57-
58-
+ Updated `license.txt` with the new year.
59-
+ Added missing online help links.
60-
+ Fixed bug in `Get-ParameterInfo` that failed to display dynamic parameters when using a command alias. ([Issue #101](https://github.com/jdhitsolutions/PSScriptTools/issues/101))
61-
+ Modified format file for `PSParameterInfo` to display `Mandatory` and `IsDynamic` values in color when the value is `$True`.
6266

6367
## Archive
6468

‎docs/Get-LastModifiedFile.md‎

Lines changed: 170 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,170 @@
1+
---
2+
external help file: PSScriptTools-help.xml
3+
Module Name: PSScriptTools
4+
online version:
5+
schema: 2.0.0
6+
---
7+
8+
# Get-LastModifiedFile
9+
10+
## SYNOPSIS
11+
12+
Get files based on last modified data.
13+
14+
## SYNTAX
15+
16+
```yaml
17+
Get-LastModifiedFile [[-Filter] <String>] [[-Path] <String>]
18+
[-Interval <String>] [-IntervalCount <Int32>] [-Recurse] [<CommonParameters>]
19+
```
20+
21+
## DESCRIPTION
22+
23+
This command is designed to make it easier to identify last modified files. You can specify by an interval such as 3 months or 24 hours.
24+
25+
## EXAMPLES
26+
27+
### Example 1
28+
29+
```powershell
30+
PS C:\> Get-LastModifiedFile -Path c:\work
31+
32+
Directory: C:\work
33+
34+
Mode LastWriteTime Length Name
35+
---- ------------- ------ ----
36+
-a--- 11/30/2021 1:52 PM 2010 a.txt
37+
-a--- 11/30/2021 1:52 PM 5640 b.txt
38+
```
39+
40+
The default behavior is to find all files modified in the last 24 hours.
41+
42+
### Example 2
43+
44+
```powershell
45+
PS C:\> Get-LastModifiedFile -Path c:\scripts -Filter *.ps1 -Interval Months -IntervalCount 6
46+
47+
Directory: C:\Scripts
48+
49+
Mode LastWriteTime Length Name
50+
---- ------------- ------ ----
51+
-a--- 11/19/2021 2:36 PM 1434 calendar-prompt.ps1
52+
-a--- 10/11/2021 11:26 AM 1376 ChangeOSCaption.ps1
53+
-a--- 8/27/2021 8:06 AM 2754 Check-ModuleUpdate.ps1
54+
-a--- 9/17/2021 9:23 AM 1822 CleanJobs.ps1
55+
-a--- 7/14/2021 10:36 AM 436 Clear-Win11Recommended.ps1
56+
-a--- 10/18/2021 5:24 PM 5893 ComingSoon.ps1
57+
-a--- 10/25/2021 5:23 PM 4966 Configure-PSVirtualMachine.ps1
58+
...
59+
```
60+
61+
Get all .ps1 files in C:\Scripts that have been modified in the last 6 months.
62+
63+
## PARAMETERS
64+
65+
### -Filter
66+
67+
Specify a file filter like *.ps1.
68+
69+
```yaml
70+
Type: String
71+
Parameter Sets: (All)
72+
Aliases:
73+
74+
Required: False
75+
Position: 0
76+
Default value: None
77+
Accept pipeline input: False
78+
Accept wildcard characters: False
79+
```
80+
81+
### -Interval
82+
83+
Specify the search interval based on the last write time.
84+
85+
```yaml
86+
Type: String
87+
Parameter Sets: (All)
88+
Aliases:
89+
Accepted values: Hours, Minutes, Days, Months, Years
90+
91+
Required: False
92+
Position: Named
93+
Default value: Hours
94+
Accept pipeline input: False
95+
Accept wildcard characters: False
96+
```
97+
98+
### -IntervalCount
99+
100+
Specify the number of intervals.
101+
102+
```yaml
103+
Type: Int32
104+
Parameter Sets: (All)
105+
Aliases: ic
106+
107+
Required: False
108+
Position: Named
109+
Default value: 24
110+
Accept pipeline input: False
111+
Accept wildcard characters: False
112+
```
113+
114+
### -Path
115+
116+
Specify the folder to search.
117+
118+
```yaml
119+
Type: String
120+
Parameter Sets: (All)
121+
Aliases:
122+
123+
Required: False
124+
Position: 1
125+
Default value: current location
126+
Accept pipeline input: False
127+
Accept wildcard characters: False
128+
```
129+
130+
### -Recurse
131+
132+
Recurse from the specified path.
133+
134+
```yaml
135+
Type: SwitchParameter
136+
Parameter Sets: (All)
137+
Aliases:
138+
139+
Required: False
140+
Position: Named
141+
Default value: None
142+
Accept pipeline input: False
143+
Accept wildcard characters: False
144+
```
145+
146+
### CommonParameters
147+
148+
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).
149+
150+
## INPUTS
151+
152+
### None
153+
154+
## OUTPUTS
155+
156+
### System.IO.FileInfo
157+
158+
## NOTES
159+
160+
This command was first described at https://jdhitsolutions.com/blog/powershell/8622/finding-modified-files-with-powershell/
161+
162+
Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
163+
164+
## RELATED LINKS
165+
166+
[Get-ChildItem]()
167+
168+
[Get-DirectoryInfo](Get-DirectoryInfo.md)
169+
170+
[Get-FolderSizeInfo](Get-FolderSizeInfo.md)

0 commit comments

Comments
 (0)