Find-PSResource

Modül:: Microsoft.PowerShell.PSResourceGet Module

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

Syntax

NameParameterSet (Varsayılan)

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

CommandNameParameterSet

Find-PSResource
    -CommandName <String[]>
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

DscResourceNameParameterSet

Find-PSResource
    -DscResourceName <String[]>
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

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

Örnekler

Örnek 1

Bu örnek PowerShell Galerisi'nde PowerShellGet paketini arar. 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, powershell galerisinde yayın öncesi sürümler de dahil olmak üzere PowerShellGet paketi 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 örnek, PowerShell Galerisi'nde Microsoft.PowerShell.SecretManagement paketini arar. 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, Get-TargetResource içeren tüm modül kaynaklarını arar. cmdlet'i komutu 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 Kaynak 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, Computerile başlayan adlara sahip kaynaklar için tüm kayıtlı PSResourceRepositories 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ı.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

CommandNameParameterSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

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

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DscResourceName

Aranacak DSC Kaynağının adı.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

DscResourceNameParameterSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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ılır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	0
Zorunlu:	False
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Prerelease

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 sonra ada göre sıralanır. Düşük Öncelik değerleri daha yüksek önceliğe sahiptir.

Birden çok depodaki kaynakları ararken, PSResourceGet cmdlet'leri 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 karakterini destekler. Birden çok depo belirtirseniz, tüm adlar joker karakteri içermelidir veya atlanmalıdır. Joker karakterlerle ve joker karakterler olmadan adların bir karışımını belirtemezsiniz.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-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.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Type

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

None
Module
Script

Parametre özellikleri

Tür:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Default value:	None
Kabul edilen değerler:	None, Module, Script, Nupkg
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 karakter 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 1.0.0.0 kullanılması 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 [1.0.0.0, ] kullanın.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Çıkışlar

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notlar

modülü, fdresFind-PSResourceiçin bir diğer ad olarak tanımlar.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?