Dela via

Find-PSResource

  • Referens
Modul:
Microsoft.PowerShell.PSResourceGet

Söker efter paket från en lagringsplats (lokal eller fjärransluten), baserat på ett namn eller andra paketegenskaper.

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

Cmdleten Find-PSResource söker efter ett paket från en lagringsplats (lokal eller fjärransluten) baserat på ett namn eller andra paketegenskaper.

Exempel

Exempel 1

Det här exemplet söker PowerShell-galleriet efter PowerShellGet-paketet. Cmdleten returnerar den högsta icke-förhandsversionen.

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…

Exempel 2

Det här exemplet söker PowerShell-galleriet efter PowerShellGet-paketet, inklusive förhandsversioner.

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…

Exempel 3

Det här exemplet söker PowerShell-galleriet efter paketet Microsoft.PowerShell.SecretManagement. Cmdleten returnerar alla versioner som uppfyller det angivna versionsintervallet .

$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  …

Exempel 4

Det här exemplet söker efter alla modulresurser som innehåller CommandNameGet-TargetResourceför . Cmdleten returnerar alla modulresurser som innehåller kommandot .

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

Exempel 5

Det här exemplet söker efter alla modulresurser som innehåller DSC-resursen SystemLocale.

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Exempel 6

Det här exemplet söker i alla registrerade PSResourceRepositories efter resurser med namn som börjar med 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…

Exempel 7

Det här exemplet visar hur du hittar moduler med en tagg. Värdet CrescendoBuilt är en tagg som läggs till automatiskt i moduler som skapats med hjälp av modulen 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…

Parametrar

-CommandName

Namnet på kommandot som du vill söka efter.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Valfria autentiseringsuppgifter som ska användas vid åtkomst till en lagringsplats.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DscResourceName

Namnet på den DSC-resurs som du vill söka efter.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeDependencies

När detta anges returnerar sökningen alla matchande resurser deras beroenden. Beroenden dedupliceras.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på en resurs som ska hittas. Jokertecken stöds men NuGet accepterar * bara tecknet. NuGet stöder inte jokerteckensökningar på lokala (filbaserade) lagringsplatser.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Prerelease

När detta anges innehåller förhandsversioner i sökresultat som returneras.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Repository

Anger ett eller flera namn på lagringsplatsen som ska sökas. Om inget anges inkluderar sökningen alla registrerade lagringsplatser i prioritetsordning (högst först) tills en lagringsplats hittas som innehåller paketet. Lagringsplatser sorteras efter prioritet och sedan efter namn. Lägre prioritetsvärden har högre prioritet.

När du söker efter resurser på flera lagringsplatser söker PSResourceGet-cmdletarna i lagringsplatserna med hjälp av den här sorteringsordningen. Find-PSResource returnerar alla matchande paket från den sorterade listan över lagringsplatser.

Parametern stöder * jokertecknet. Om du anger flera lagringsplatser måste alla namn innehålla eller utelämna jokertecknet. Du kan inte ange en blandning av namn med och utan jokertecken.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Tag

Filtrerar sökresultat för resurser som innehåller de angivna taggarna. Om flera taggar anges returnerar cmdleten endast resurser som innehåller alla angivna taggar.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Type

Anger en eller flera resurstyper som ska hittas. Resurstyper som stöds är:

  • None
  • Module
  • Script
Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Godkända värden:None, Module, Script
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Version

Anger vilken version av resursen som ska returneras. Värdet kan vara en exakt version eller ett versionsintervall med hjälp av syntaxen för NuGet-versionshantering.

Jokertecken stöds men NuGet accepterar bara jokertecken *. Mer information om NuGet-versionsintervall finns i Paketversionshantering.

PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Användning 1.0.0.0 som version ger inte versionerna 1.0.0.0 och senare (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inklusivintervall använder [1.0.0.0, ] du som versionsintervall.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

Indata

String[]

Utdata

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Kommentarer

Modulen definierar fdres som ett alias för Find-PSResource.