Skip to content

Commit 88ee5df

Browse files
sdwheelerbobbytreed
authored andcommitted
Fixes #4415 - clarify wildcards for -Filter (#4561)
1 parent d123732 commit 88ee5df

File tree

6 files changed

+30
-34
lines changed

6 files changed

+30
-34
lines changed

reference/3.0/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -570,12 +570,11 @@ Accept wildcard characters: True
570570

571571
### -Filter
572572

573-
Specifies a filter in the format or language of the provider. The value of this parameter qualifies
574-
the **Path** parameter.
575-
576-
The syntax of the filter, including the use of wildcard characters, depends on the provider. Filters
577-
are more efficient than other parameters, because the provider applies them when the cmdlet gets the
578-
objects. Otherwise, PowerShell filters the objects after they are retrieved.
573+
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
574+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
575+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
576+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
577+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
579578

580579
```yaml
581580
Type: String
@@ -586,7 +585,7 @@ Required: False
586585
Position: 1
587586
Default value: None
588587
Accept pipeline input: False
589-
Accept wildcard characters: False
588+
Accept wildcard characters: True
590589
```
591590

592591
### -Include

reference/4.0/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -483,12 +483,11 @@ Accept wildcard characters: False
483483

484484
### -Filter
485485

486-
Specifies a filter in the format or language of the provider. The value of this parameter qualifies
487-
the **Path** parameter.
488-
489-
The syntax of the filter, including the use of wildcard characters, depends on the provider. Filters
490-
are more efficient than other parameters, because the provider applies them when the cmdlet gets the
491-
objects. Otherwise, PowerShell filters the objects after they are retrieved.
486+
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
487+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
488+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
489+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
490+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
492491

493492
```yaml
494493
Type: String

reference/5.0/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -509,12 +509,11 @@ Accept wildcard characters: False
509509

510510
### -Filter
511511

512-
Specifies a filter in the format or language of the provider. The value of this parameter qualifies
513-
the **Path** parameter.
514-
515-
The syntax of the filter, including the use of wildcard characters, depends on the provider. Filters
516-
are more efficient than other parameters, because the provider applies them when the cmdlet gets the
517-
objects. Otherwise, PowerShell filters the objects after they are retrieved.
512+
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
513+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
514+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
515+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
516+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
518517

519518
```yaml
520519
Type: String
@@ -525,7 +524,7 @@ Required: False
525524
Position: 1
526525
Default value: None
527526
Accept pipeline input: False
528-
Accept wildcard characters: False
527+
Accept wildcard characters: True
529528
```
530529

531530
### -Force

reference/5.1/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -511,12 +511,11 @@ Accept wildcard characters: False
511511

512512
### -Filter
513513

514-
Specifies a filter in the format or language of the provider. The value of this parameter qualifies
515-
the **Path** parameter.
516-
517-
The syntax of the filter, including the use of wildcard characters, depends on the provider. Filters
518-
are more efficient than other parameters, because the provider applies them when the cmdlet gets the
519-
objects. Otherwise, PowerShell filters the objects after they are retrieved.
514+
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
515+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
516+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
517+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
518+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
520519

521520
```yaml
522521
Type: String

reference/6/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -501,10 +501,10 @@ Accept wildcard characters: False
501501
### -Filter
502502

503503
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
504-
provider is the only installed PowerShell provider that supports the use of filters. You can find
505-
the syntax for the **FileSystem** filter language in [about_Wildcards](../Microsoft.PowerShell.Core/About/about_Wildcards.md).
506-
Filters are more efficient than other parameters, because the provider applies them when the cmdlet
507-
gets the objects rather than having PowerShell filter the objects after they are retrieved.
504+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
505+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
506+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
507+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
508508

509509
```yaml
510510
Type: String

reference/7/Microsoft.PowerShell.Management/Get-ChildItem.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -501,10 +501,10 @@ Accept wildcard characters: False
501501
### -Filter
502502

503503
Specifies a filter to qualify the **Path** parameter. The [FileSystem](../Microsoft.PowerShell.Core/About/about_FileSystem_Provider.md)
504-
provider is the only installed PowerShell provider that supports the use of filters. You can find
505-
the syntax for the **FileSystem** filter language in [about_Wildcards](../Microsoft.PowerShell.Core/About/about_Wildcards.md).
506-
Filters are more efficient than other parameters, because the provider applies them when the cmdlet
507-
gets the objects rather than having PowerShell filter the objects after they are retrieved.
504+
provider is the only installed PowerShell provider that supports the use of filters. Filters are
505+
more efficient than other parameters, because the provider applies them when the cmdlet gets the
506+
objects rather than having PowerShell filter the objects after they are retrieved. The filter string
507+
is passed to the .NET API to enumerate files. That API only supports `*` and `?` wildcards.
508508

509509
```yaml
510510
Type: String

0 commit comments

Comments
 (0)