Find-PSResource

Reference

Modul:: Microsoft.PowerShell.PSResourceGet

Vyhledá balíčky z úložiště (místní nebo vzdálené) na základě názvu nebo jiných vlastností balíčku.

Syntaxe

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

Rutina Find-PSResource vyhledá balíček z úložiště (místního nebo vzdáleného) na základě názvu nebo jiných vlastností balíčku.

Příklady

Příklad 1

Tento příklad hledá Galerie prostředí PowerShell balíček PowerShellGet. Rutina vrátí nejvyšší verzi, která není předběžná.

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…

Příklad 2

Tento příklad hledá Galerie prostředí PowerShell balíček PowerShellGet, včetně předběžných verzí.

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…

Příklad 3

Tento příklad hledá Galerie prostředí PowerShell balíček Microsoft.PowerShell.SecretManagement. Rutina vrátí všechny verze, které splňují zadaný rozsah verzí .

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

Příklad 4

Tento příklad vyhledá všechny prostředky modulu, které obsahují CommandName pro Get-TargetResource. Rutina vrátí všechny prostředky modulu, které příkaz zahrnují.

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

Příklad 5

Tento příklad vyhledá všechny prostředky modulu, které obsahují prostředek SystemLocaleDSC .

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Příklad 6

Tento příklad prohledá všechny registrované PSResourceRepositories pro prostředky s názvy začínající na 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…

Příklad 7

Tento příklad ukazuje, jak najít moduly podle značky. Hodnota CrescendoBuilt je značka, která se automaticky přidá do modulů vytvořených pomocí modulu 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…

Parametry

-CommandName

Název příkazu, který chcete vyhledat.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Credential

Volitelné přihlašovací údaje, které se mají použít při přístupu k úložišti.

Typ:	PSCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DscResourceName

Název prostředku DSC, který chcete vyhledat.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IncludeDependencies

Pokud je zadáno, vrátí vyhledávání všechny odpovídající prostředky, jejich závislosti. Závislosti jsou odstraněny z duplicitních dat.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název prostředku, který chcete najít. Zástupné znaky jsou podporované, ale NuGet přijímá * pouze znak. NuGet nepodporuje vyhledávání pomocí zástupných znaků v místních úložištích (založených na souborech).

Typ:	String[]
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-Prerelease

Pokud je zadáno, zahrne do vrácených výsledků hledání předběžné verze.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Repository

Určuje jeden nebo více názvů úložišť, které se mají prohledávat. Pokud není zadáno, bude hledání zahrnovat všechna registrovaná úložiště v pořadí priority (nejvyšší na prvním místě), dokud se nenajde úložiště, které obsahuje balíček. Úložiště se seřadí podle priority a pak podle názvu. Hodnoty s nižší prioritou mají vyšší prioritu.

Při hledání prostředků ve více úložištích prohledávají rutiny PSResourceGet úložiště pomocí tohoto pořadí řazení. Find-PSResource vrátí všechny odpovídající balíčky z seřazeného seznamu úložišť.

Parametr podporuje * zástupný znak. Pokud zadáte více úložišť, musí všechny názvy obsahovat nebo vynechat zástupný znak. Nemůžete zadat kombinaci názvů se zástupnými znakůmi a bez zástupných znaků.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-Tag

Filtruje výsledky hledání pro prostředky, které obsahují zadané značky. Pokud je zadáno více značek, rutina vrátí pouze prostředky, které obsahují všechny poskytnuté značky.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Type

Určuje jeden nebo více typů prostředků, které se mají najít. Podporované typy prostředků jsou:

None
Module
Script

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Přípustné hodnoty:	None, Module, Script
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Version

Určuje verzi prostředku, který se má vrátit. Hodnota může být přesná verze nebo rozsah verzí pomocí syntaxe správy verzí NuGet.

Zástupné znaky jsou podporované, ale NuGet přijímá pouze zástupný znak *. Další informace o rozsahech verzí NuGet najdete v tématu Správa verzí balíčků.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0 jako verze nedává verze 1.0.0.0 a vyšší (minimální rozsah včetně). Místo toho se hodnota považuje za požadovanou verzi. Pokud chcete vyhledat minimální inkluzivní rozsah, použijte [1.0.0.0, ] jako rozsah verzí.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	True

Vstupy

String[]

Výstupy

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Poznámky

Modul se fdres definuje jako alias pro Find-PSResource.

Sdílet prostřednictvím