Find-PSResource

Başvuru

Modül:: Microsoft.PowerShell.PSResourceGet

Bir depodaki (yerel veya uzak) paketleri bir ada veya diğer paket özelliklerine göre arar.

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

cmdlet'i Find-PSResource bir ad veya diğer paket özelliklerine göre bir depodan (yerel veya uzak) bir paket arar.

Örnekler

Örnek 1

Bu örneklerde PowerShell Galerisi PowerShellGet paketi aranır. Cmdlet, yayın öncesi olmayan en yüksek sürümü döndürür.

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…

Örnek 2

Bu örneklerde, yayın öncesi sürümler de dahil olmak üzere PowerShellGet paketi için PowerShell Galerisi aranır.

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…

Örnek 3

Bu örneklerde PowerShell Galerisi Microsoft.PowerShell.SecretManagement paketi aranmaktadır. Cmdlet, belirtilen Sürüm aralığını karşılayan tüm sürümleri döndürür.

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

Örnek 4

Bu örnek, CommandNameGet-TargetResourcedeğerini içeren tüm modül kaynaklarını arar. cmdlet'i, komutunu içeren tüm modül kaynaklarını döndürür.

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

Örnek 5

Bu örnek, DSC Kaynağını SystemLocaleiçeren tüm modül kaynaklarını arar.

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Örnek 6

Bu örnekte, ile Computerbaşlayan adlara sahip tüm kayıtlı PSResourceRepositories kaynakları aranıyor.

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…

Örnek 7

Bu örnekte modülleri etikete göre bulma gösterilmektedir. CrescendoBuilt değeri, Microsoft.PowerShell.Crescendo modülü kullanılarak oluşturulan modüllere otomatik olarak eklenen bir etikettir.

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…

Parametreler

-CommandName

Aranacak komutun adı.

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

-Credential

Bir depoya erişirken kullanılacak isteğe bağlı kimlik bilgileri.

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

-DscResourceName

Aranacak DSC Kaynağının adı.

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

-IncludeDependencies

Belirtildiğinde, arama tüm eşleşen kaynakları bağımlılıklarını döndürür. Bağımlılıklar yinelenenleri kaldırılmış.

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

-Name

Bulunacak kaynağın adı. Joker karakterler desteklenir, ancak NuGet yalnızca karakteri kabul eder * . NuGet, yerel (dosya tabanlı) depolarda joker karakter aramalarını desteklemez.

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

-Prerelease

Belirtildiğinde, döndürülen arama sonuçlarına yayın öncesi sürümleri ekler.

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

-Repository

Aranacak bir veya daha fazla depo adını belirtir. Belirtilmezse, paketi içeren bir depo bulunana kadar arama tüm kayıtlı depoları öncelik sırasına göre (en yüksek önce) içerir. Depolar önceliğe ve ardından ada göre sıralanır. Düşük Öncelik değerleri daha yüksek önceliğe sahiptir.

PsResourceGet cmdlet'leri, birden çok depodaki kaynakları ararken bu sıralama düzenini kullanarak depolarda arama uygular. Find-PSResource sıralanmış depo listesinden eşleşen tüm paketleri döndürür.

parametresi joker karakteri destekler * . Birden çok depo belirtirseniz, tüm adlar joker karakteri içermelidir veya atlanmalıdır. Joker karakterlerle ve joker karakterler olmadan adların karışımını belirtemezsiniz.

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

-Tag

Belirtilen etiketleri içeren kaynaklar için arama sonuçlarını filtreler. Birden çok etiket belirtilirse, cmdlet yalnızca sağlanan tüm etiketleri içeren kaynakları döndürür.

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

-Type

Bulunacak bir veya daha fazla kaynak türünü belirtir. Desteklenen kaynak türleri şunlardır:

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

Döndürülecek kaynağın sürümünü belirtir. Değer, NuGet sürüm oluşturma söz dizimini kullanarak tam bir sürüm veya sürüm aralığı olabilir.

Joker karakterler desteklenir, ancak NuGet yalnızca joker karakterini *kabul eder. NuGet sürüm aralıkları hakkında daha fazla bilgi için bkz. Paket sürümü oluşturma.

PowerShellGet, NuGet sürüm aralığı belgelerinde listelenen en düşük dahil sürüm hariç tüm sürümleri destekler. sürüm olarak kullanılması 1.0.0.0 1.0.0.0 ve üzeri sürümleri (en düşük kapsayıcı aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsayıcı aralığı aramak için sürüm aralığı olarak kullanın [1.0.0.0, ] .

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

Girişler

String[]

Çıkışlar

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notlar

modülü için Find-PSResourcediğer ad olarak tanımlarfdres.

Share via