Zoeken naar ScriptFind-Script

Zoeken naar de PowerShell-scriptbestanden vanuit een online-galerie die voldoen aan opgegeven criteria.Finds the PowerShell script files from an online gallery that match specified criteria.

BeschrijvingDescription

Zoeken naar Script detecteert de scriptbestanden van geregistreerde opslagplaatsen die overeenkomt met de opgegeven criteria.Find-Script discovers the script files from registered repositories that matches the specified criteria. Voor elk script dat wordt gevonden, retourneert zoeken Script een PSRepositoryItemInfo-object dat kan eventueel worden doorgesluisd naar het Script voor installatie voor het installeren van de scripts.For each script found, Find-Script returns a PSRepositoryItemInfo object which can optionally be piped to Install-Script for installing the scripts. Zoeken naar Script cmdlet kunt u voor het detecteren van de scriptbestanden met verschillende zoekcriteria zoals naam, label, filter, opdrachtnaam, het bereik van versie, exacte versie, alle versies, inclusief de bijbehorende afhankelijkheden en van bepaalde of alle geregistreerde-opslagplaatsen.Find-Script cmdlet lets you to discover the script files with different search criteria like name, tag, filter, command name, version range, exact version, all versions, including its dependencies and from specific or all registered repositories.

  • Zoeken naar Script kunt filteren op basis van een script met de opdracht - inhoud en - parameters bevat.Find-Script can filter based on script contents with the -Command and -Includes parameters.
  • Zoeken naar Script kunt filteren met Versieparameters: MinimumVersion, MaximumVersion, RequiredVersion, AllVersions.Find-Script can filter with version parameters: MinimumVersion, MaximumVersion, RequiredVersion, AllVersions.
    • Deze parameters zijn, met uitzondering van MinmimumVersion en MaximumVersion, sluiten elkaar wederzijds uit.These parameters are mutually exclusive, except MinmimumVersion and MaximumVersion.
    • Deze Versieparameters zijn alleen met de naam van één script zonder eventuele jokertekens toegestaan.These version parameters are allowed only with the single script name without any wildcards.
    • Als de parameter RequiredVersion niet is opgegeven, retourneert Find-Script de meest recente versie van het script dat gelijk is aan of groter is dan de opgegeven minimumversie of de nieuwste versie van het script als er geen minimum versie is opgegeven.If the RequiredVersion parameter is not specified, Find-Script returns the latest version of the script that is equal to or greater than the minimum version specified or the latest version of the script if no minimum version is specified.
    • Als de parameter RequiredVersion is opgegeven, zijn zoeken Script retourneert alleen de versie van script die exact overeenkomt met de opgegeven versie.If the RequiredVersion parameter is specified, Find-Script only returns the version of script that exactly matches the specified version.
  • Zoeken naar Script kunt filteren op de metagegevens van het script met de - parameter van label.Find-Script can filter on script metadata with the -Tag parameter.
  • Zoeken naar Script kunt filteren op zoektaal opslagplaats-specifieke met de - parameter Filter.Find-Script can filter on repository-specific search language with the -Filter parameter.
  • Zoeken naar Script kunt filteren op scripts van alle of enkele van de geregistreerde opslagplaatsen.Find-Script can filter on scripts from all or few of the registered repositories.

Opmerking: geregistreerde PSRepository moet een geldige ScriptSourceLocation hebben.NOTE: Registered PSRepository should have a valid ScriptSourceLocation. U kunt de Set-PSRepository ScriptSourceLocation waarde instellen.You can use the Set-PSRepository to set ScriptSourceLocation value.

De syntaxis van cmdletCmdlet syntax

Get-Command -Name Find-Script -Module PowerShellGet -Syntax

Verwijzing naar het online help van cmdletCmdlet online help reference

Zoeken naar ScriptFind-Script

VoorbeeldopdrachtenExample commands

# Find a script from the registered repository with ScriptSourceLocation
Find-Script Connect-AzureVM

Version    Name                                Repository           Description
-------    ----                                ----------           -----------
1.0        Connect-AzureVM                     PSGallery            This runbook sets up a connection to an Azure vi...

# Find multiple scripts
Find-Script -Name Connect-AzureVM, Show-Tree, Connect-O365

# Find scripts with wildcards in -Name
Find-Script -Name *Azure*

# Find all versions of a script
Find-Script -Name Connect-O365 -AllVersions

# Find a script with -MinimumVersion. 
# With MinimumVersion we can find a script whose version is greate than or equal to the specified MinimumVersion value.
Find-Script Connect-O365 -MinimumVersion 1.4

# Find a script with MaximumVersion
Find-Script -Name Connect-O365 -MaximumVersion 1.6.2

# Find a script with both MinimumVersion and MaximumVersion range.
Find-Script -Name Connect-O365 -MinimumVersion 1.1 -MaximumVersion 1.6.2

# Find a script with exact version
Find-Script -Name Connect-O365 -RequiredVersion 1.5.7

# Find a script with a specific pre-release version
Find-Script -Name Connect-O365 -RequiredVersion 1.3.2-alpha -AllowPrerelease

# Find a script from the specified repository
Find-Script -Name Fabrikam-ServerScript -Repository MyLocalRepo

# Find available scripts from all registered repositories
Find-Script

# Find available scripts from few registered repositories
Find-Script -Repository PSGallery, PrivatePSGallery

# Find a script along with its dependent modules and scripts
Find-Script -Name Connect-AzureVM -IncludeDependencies

Version    Name                                Repository           Description
-------    ----                                ----------           -----------
1.0        Connect-AzureVM                     PSGallery            This runbook sets up a connection to an Azure vi...
1.4.0      Azure                               PSGallery            Microsoft Azure PowerShell - Service Management
1.1.2      Azure.Storage                       PSGallery            Microsoft Azure PowerShell - Storage service cmd...
1.0.8      AzureRM.profile                     PSGallery            Microsoft Azure PowerShell - Profile credential ...

# Find all scripts with workflows
Find-Script -Includes Workflow

# Find all scripts with functions
Find-Script -Includes Function

# Find scripts with specific commands
Find-Script -Command Log-Message
Find-Script -Command Log-Message, Show-Tree -Includes Function
Find-Script -Command Connect-AzureVM -Includes Workflow

# Find scripts with -Filter based search. -Filter searches in description and names
Find-Script -Filter Windows
Find-Script -Filter Azure

# Find all scripts with tags O365 or Nano
Find-Script -Tag O365, Nano

# Properties of Find-Script returned object
Find-Script Show-Tree | Format-List * -Force
Name                       : Show-Tree
Version                    : 1.0.0
Type                       : Script
Description                : Script to show the layout of PowerShell namespaces (Trees) using ASCII
Author                     : Jeffrey Snover
CompanyName                : jsnover
Copyright                  : (C) Microsoft Corporation. All rights reserved.
PublishedDate              : 2/15/2016 10:15:35 PM
InstalledDate              :
UpdatedDate                :
LicenseUri                 :
ProjectUri                 :
IconUri                    :
Tags                       : {Nano, PSScript}
Includes                   : {Function, RoleCapability, Command, DscResource...}
PowerShellGetFormatVersion :
ReleaseNotes               :
Dependencies               : {}
RepositorySourceLocation   : https://www.powershellgallery.com/api/v2/
Repository                 : PSGallery
PackageManagementProvider  : NuGet
AdditionalMetadata         : {versionDownloadCount, ItemType, copyright, PackageManagementProvider...}


# Includes property on PSRepositoryItemInfo object
$t = Find-Script -Includes Workflow -Repository INT -Name Fabrikam-ClientScript
$t.Includes

Name                           Value
----                           -----
Function                       {Test-FunctionFromScript_Fabrikam-ClientScript}
RoleCapability                 {}
Command                        {Test-FunctionFromScript_Fabrikam-ClientScript, Test-WorkflowFromScript_Fabrikam-Clie...
DscResource                    {}
Workflow                       {Test-WorkflowFromScript_Fabrikam-ClientScript}
Cmdlet                         {}