Find-PSResource

Zoekt naar pakketten uit een opslagplaats (lokaal of extern), op basis van een naam of andere pakketeigenschappen.

Syntax

Find-PSResource
    [[-Name] <String[]>]
    [-Type <ResourceType>]
    [-Version <String>]
    [-Prerelease]
    [-Tag <String[]>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeDependencies]
    [<CommonParameters>]
Find-PSResource
    [-Prerelease]
    -CommandName <String[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]
Find-PSResource
    [-Prerelease]
    -DscResourceName <String[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

De Find-PSResource cmdlet zoekt naar een pakket uit een opslagplaats (lokaal of extern) op basis van een naam of andere pakketeigenschappen.

Voorbeelden

Voorbeeld 1

In dit voorbeeld wordt PowerShell Gallery gezocht naar het PowerShellGet-pakket. De cmdlet retourneert de hoogste niet-voorlopige versie.

Find-PSResource -Name PowerShellGet -Repository PSGallery

Name          Version Prerelease Repository Description
----          ------- ---------- ---------- -----------
PowerShellGet 2.2.5              PSGallery  PowerShell module with commands for discovering, installing, updating and p…

Voorbeeld 2

In dit voorbeeld wordt PowerShell Gallery gezocht naar het PowerShellGet-pakket, inclusief voorlopige versies.

Find-PSResource -Name PowerShellGet -Repository PSGallery -Prerelease

Name          Version Prerelease Repository Description
----          ------- ---------- ---------- -----------
PowerShellGet 3.0.21  beta21     PSGallery  PowerShell module with commands for discovering, installing, updating and p…

Voorbeeld 3

In dit voorbeeld wordt PowerShell Gallery gezocht naar het pakket Microsoft.PowerShell.SecretManagement. De cmdlet retourneert alle versies die voldoen aan het opgegeven versiebereik .

$parameters = @{
    Name = 'Microsoft.PowerShell.SecretManagement'
    Version = '(0.9.0.0, 1.2.0.0]'
    Repository = 'PSGallery'
    Prerelease = $true
}
Find-PSResource @parameters

Name                                  Version Prerelease Repository Description
----                                  ------- ---------- ---------- -----------
Microsoft.PowerShell.SecretManagement 1.1.2              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.1              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0   preview2   PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0   preview    PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.0.1              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.0.0              PSGallery  …
Microsoft.PowerShell.SecretManagement 0.9.1              PSGallery  …

Voorbeeld 4

In dit voorbeeld wordt gezocht naar alle moduleresources die de CommandName van Get-TargetResourcebevatten. De cmdlet retourneert alle moduleresources die de opdracht bevatten.

Find-PSResource -CommandName Get-TargetResource -Repository PSGallery

Name                 Package Name               Version
----                 ------------               -------
{Get-TargetResource} cRegFile                   1.2
{Get-TargetResource} cVNIC                      1.0.0.0
{Get-TargetResource} cWindowsErrorReporting     1.1
{Get-TargetResource} OctopusDSC                 4.0.1131
{Get-TargetResource} supVsts                    1.1.17.0
{Get-TargetResource} SystemLocaleDsc            1.2.0.0
{Get-TargetResource} WindowsDefender            1.0.0.4
{Get-TargetResource} xInternetExplorerHomePage  1.0.0
{Get-TargetResource} xPowerShellExecutionPolicy 3.1.0.0

Voorbeeld 5

In dit voorbeeld wordt gezocht naar alle moduleresources die de DSC-resource SystemLocalebevatten.

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

Name           Package Name          Version
----           ------------          -------
{SystemLocale} ComputerManagementDsc 9.0.0
{SystemLocale} SystemLocaleDsc       1.2.0.0

Voorbeeld 6

In dit voorbeeld worden alle geregistreerde PSResourceRepositories gezocht naar resources met namen die beginnen met Computer.

Find-PSResource -Name Computer*

Name                                              Version Prerelease Repository Description
----                                              ------- ---------- ---------- -----------
ComputerManagementDsc                             9.0.0              PSGallery  DSC resources for configuration of a Wi…
ComputerManagement                                1.1.2.3            PSGallery  A PowerShell module for working with th…
ComputerCleanup                                   1.2.0              PSGallery  Module for freeing up disk space / remo…
Computer_UnjoinDomainAndJoinWorkgroup_Config      1.0.0              PSGallery  This example switches the computer 'Ser…
Computer_SetComputerDescriptionInWorkgroup_Config 1.0.0              PSGallery  This example will set the computer desc…
Computer_RenameComputerInWorkgroup_Config         1.0.0              PSGallery  This example will set the machine name …
Computer_RenameComputerInDomain_Config            1.0.0              PSGallery  This example will change the machines n…
Computer_RenameComputerAndSetWorkgroup_Config     1.0.0              PSGallery  This configuration will set the compute…
Computer_JoinDomainSpecifyingDC_Config            1.0.0              PSGallery  This configuration sets the machine nam…
Computer_JoinDomain_Config                        1.0.0              PSGallery  This configuration sets the machine nam…

Voorbeeld 7

In dit voorbeeld ziet u hoe u modules kunt vinden op basis van een tag. De CrescendoBuilt waarde is een tag die automatisch wordt toegevoegd aan modules die zijn gemaakt met behulp van de module Microsoft.PowerShell.Crescendo .

Find-PSResource -Tag CrescendoBuilt

Name            Version Prerelease Repository Description
----            ------- ---------- ---------- -----------
AptPackage      0.0.2              PSGallery  PowerShell Crescendo-generated Module to query APT-Package Information
Cobalt          0.4.0              PSGallery  A PowerShell Crescendo wrapper for WinGet
Croze           0.0.5              PSGallery  A PowerShell Crescendo wrapper for Homebrew
Foil            0.3.0              PSGallery  A PowerShell Crescendo wrapper for Chocolatey
Image2Text      1.0.2              PSGallery  PowerShell Images into ASCII art
pastel          1.0.1              PSGallery  PowerShell commands for pastel
PSDupes         0.0.1              PSGallery  A crescendo module to locate duplicate files. Very fast and easy to use, …
psFilesCli      0.0.3              PSGallery  A PowerShell wrapper for files-cli.exe
PSLogParser     0.0.2              PSGallery  Crescendo Powershell module for Log Parser 2.2
Quser.Crescendo 0.1.3              PSGallery  This module displays session information of users logged onto a local or …
RoboCopy        1.0.1              PSGallery  PowerShell cmdlet for the official RoboCopy.exe
SpeedTest-CLI   1.0.1              PSGallery  PowerShell cmdlets for Internet Speed Test
SpeedTestCLI    1.0.0              PSGallery  PowerShell cmdlets speedtest-cli
SysInternals    1.1.0              PSGallery  PowerShell cmdlets for SysInternal tools
Takeown         1.0.2              PSGallery  Crescendo Powershell wrapper of takeown.exe
TShark          1.0.2              PSGallery  PowerShell cmdlet for tshark.exe
VssAdmin        0.8.0              PSGallery  This is a Crescendo module to wrap the Windows `vssadmin.exe` command-lin…

Parameters

-CommandName

De naam van de opdracht die u wilt zoeken.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Optionele referenties die moeten worden gebruikt bij het openen van een opslagplaats.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DscResourceName

De naam van de DSC-resource die u wilt zoeken.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDependencies

Wanneer dit is opgegeven, retourneert de zoekopdracht alle overeenkomende resources hun afhankelijkheden. Afhankelijkheden worden ontdubbeld.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

De naam van een resource die u wilt zoeken. Jokertekens worden ondersteund, maar NuGet accepteert alleen het * teken. NuGet biedt geen ondersteuning voor zoekopdrachten met jokertekens in lokale (op bestanden gebaseerde) opslagplaatsen.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Prerelease

Wanneer dit is opgegeven, worden voorlopige versies opgenomen in zoekresultaten die worden geretourneerd.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

Hiermee geeft u een of meer namen van opslagplaatsen om te zoeken. Als dit niet is opgegeven, bevat de zoekopdracht alle geregistreerde opslagplaatsen, in volgorde van prioriteit (hoogste eerst), totdat er een opslagplaats wordt gevonden die het pakket bevat. Opslagplaatsen worden gesorteerd op prioriteit en vervolgens op naam. Waarden met een lagere prioriteit hebben een hogere prioriteit.

Bij het zoeken naar resources in meerdere opslagplaatsen, doorzoeken de PSResourceGet-cmdlets de opslagplaatsen met behulp van deze sorteervolgorde. Find-PSResource retourneert alle overeenkomende pakketten uit de gesorteerde lijst met opslagplaatsen.

De parameter ondersteunt het * jokerteken. Als u meerdere opslagplaatsen opgeeft, moeten alle namen het jokerteken bevatten of weglaten. U kunt geen combinatie van namen met en zonder jokertekens opgeven.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Tag

Hiermee filtert u de zoekresultaten voor resources die de opgegeven tags bevatten. Als er meerdere tags zijn opgegeven, retourneert de cmdlet alleen resources die alle opgegeven tags bevatten.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Hiermee geeft u een of meer resourcetypen te zoeken. Ondersteunde resourcetypen zijn:

  • None
  • Module
  • Script
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Accepted values:None, Module, Script
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Hiermee geeft u de versie van de resource die moet worden geretourneerd. De waarde kan een exacte versie of een versiebereik zijn met behulp van de NuGet-versiebeheersyntaxis.

Jokertekens worden ondersteund, maar NuGet accepteert alleen jokertekens *. Zie Pakketversiebeheer voor meer informatie over NuGet-versiebereiken.

PowerShellGet ondersteunt alle, behalve de minimale inclusief versie die wordt vermeld in de documentatie over het NuGet-versiebereik. Als 1.0.0.0 u als versie gebruikt, levert geen versies 1.0.0.0 en hoger op (minimaal inclusief bereik). In plaats daarvan wordt de waarde beschouwd als de vereiste versie. Als u wilt zoeken naar een minimaal inclusief bereik, gebruikt [1.0.0.0, ] u als het versiebereik.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Invoerwaarden

String[]

Uitvoerwaarden

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notities

De module definieert fdres als een alias voor Find-PSResource.