Find-PSResource

Referencia

Módulo:: Microsoft.PowerShell.PSResourceGet

Busca paquetes de un repositorio (local o remoto), en función de un nombre u otras propiedades del paquete.

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

El Find-PSResource cmdlet busca un paquete desde un repositorio (local o remoto) en función de un nombre u otras propiedades del paquete.

Ejemplos

Ejemplo 1

En este ejemplo se busca Galería de PowerShell para el paquete PowerShellGet. El cmdlet devuelve la versión preliminar más alta.

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…

Ejemplo 2

En este ejemplo se busca Galería de PowerShell para el paquete PowerShellGet, incluidas las versiones preliminares.

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…

Ejemplo 3

En estos ejemplos se busca Galería de PowerShell para el paquete Microsoft.PowerShell.SecretManagement. El cmdlet devuelve todas las versiones que satisfacen el intervalo de versiones especificado.

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

Ejemplo 4

En este ejemplo se buscan todos los recursos del módulo que contienen commandName de Get-TargetResource. El cmdlet devuelve todos los recursos del módulo que incluyen el comando .

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

Ejemplo 5

En este ejemplo se buscan todos los recursos del módulo que contienen el recurso SystemLocalede DSC .

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Ejemplo 6

En este ejemplo se busca en todos los recursos registrados PSResourceRepositories con nombres que comienzan por 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…

Ejemplo 7

En este ejemplo se muestra cómo buscar módulos mediante una etiqueta . El CrescendoBuilt valor es una etiqueta que se agrega automáticamente a los módulos creados mediante el módulo 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…

Parámetros

-CommandName

Nombre del comando que se va a buscar.

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

-Credential

Credenciales opcionales que se usarán al acceder a un repositorio.

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

-DscResourceName

Nombre del recurso de DSC que se va a buscar.

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

-IncludeDependencies

Cuando se especifica, la búsqueda devuelve todos los recursos coincidentes de sus dependencias. Las dependencias se desduplican.

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

-Name

Nombre de un recurso que se va a buscar. Se admiten caracteres comodín, pero NuGet solo acepta el * carácter. NuGet no admite búsquedas con caracteres comodín de repositorios locales (basados en archivos).

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

-Prerelease

Cuando se especifica, incluye versiones preliminares en los resultados de búsqueda devueltos.

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

-Repository

Especifica uno o varios nombres de repositorio que se van a buscar. Si no se especifica, la búsqueda incluye todos los repositorios registrados, en orden de prioridad (primero más alto), hasta que se encuentre un repositorio que contenga el paquete. Los repositorios se ordenan por prioridad y, a continuación, por nombre. Los valores de prioridad inferior tienen una prioridad mayor.

Al buscar recursos en varios repositorios, los cmdlets PSResourceGet buscan en los repositorios mediante este criterio de ordenación. Find-PSResource devuelve todos los paquetes coincidentes de la lista ordenada de repositorios.

El parámetro admite el * carácter comodín. Si especifica varios repositorios, todos los nombres deben incluir o omitir el carácter comodín. No se puede especificar una combinación de nombres con y sin caracteres comodín.

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

-Tag

Filtra los resultados de búsqueda de los recursos que incluyen las etiquetas especificadas. Si se especifican varias etiquetas, el cmdlet solo devuelve recursos que incluyen todas las etiquetas proporcionadas.

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

-Type

Especifica uno o varios tipos de recursos que se van a buscar. Los tipos de recursos admitidos son:

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

Especifica la versión del recurso que se va a devolver. El valor puede ser una versión exacta o un intervalo de versiones mediante la sintaxis de control de versiones de NuGet.

Se admiten caracteres comodín, pero NuGet solo acepta el carácter *comodín . Para obtener más información sobre los intervalos de versiones de NuGet, consulte Control de versiones de paquetes.

PowerShellGet admite todas las versiones inclusivas, excepto la mínima, que se muestra en la documentación del intervalo de versiones de NuGet. El uso 1.0.0.0 de como versión no produce las versiones 1.0.0.0 y posteriores (intervalo inclusivo mínimo). En su lugar, el valor se considera la versión necesaria. Para buscar un intervalo inclusivo mínimo, use [1.0.0.0, ] como intervalo de versiones.

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

Entradas

String[]

Salidas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notas

El módulo define fdres como alias para Find-PSResource.