Command

Find-ManagedModule

Module: PSPublishModule
Inputs: System.String[]
Outputs: PowerForge.ManagedModuleVersionInfo

Finds module versions from a managed module repository.

Syntax

Find-ManagedModule
[-AllVersions]
[-Credential <PSCredential>]
[-CredentialSecret <String>]
[-CredentialSecretFilePath <String>]
[-CredentialUserName <String>]
[-First <Int32>]
[-IncludeDependencies]
[[-Name] <String[]>]
[-Prerelease]
[-ProfileName <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[[-Repository] <String>]
[-RepositoryName <String>]
[-ResourceType <Module>]
[-Tag <String[]>]
[-Version <String>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Description

This command is the module-package equivalent of Find-PSResource. It queries NuGet-compatible or local-folder repositories through the managed C# repository client and returns typed module version objects that can be piped to Install-ManagedModule or Save-ManagedModule.

Name, exact/range version, prerelease, tag, and dependency searches are supported for module packages. Command-name and DSC-resource-name searches inspect package contents and remain outside this fast metadata path.

Examples

Find the latest stable version of a module

Find-ManagedModule -Name Company.Tools

Find modules using a wildcard package id

Find-ManagedModule -Name Company.* -Repository C:\Packages

Find all versions from a local folder feed

Find-ManagedModule -Name Company.Tools -Repository C:\Packages -AllVersions -AllowPrerelease

Find versions in a NuGet range and pipe the typed results to save

Find-ManagedModule -Name Company.Tools -Version '[1.2.0,2.0.0)' -ProfileName CompanyModules | Save-ManagedModule -Path C:\OfflineModules

Parameters

-AllVersions SwitchParameter optional: Return all matching versions instead of only the latest selected version.
-Credential PSCredential optional: Optional repository credential.
-CredentialSecret String optionalaliases: Password, Token: Optional repository credential secret.
-CredentialSecretFilePath String optionalaliases: CredentialPath, TokenPath: Optional path to a file containing the repository credential secret.
-CredentialUserName String optionalaliases: UserName: Optional repository credential username.
-First Int32 optional: Maximum search results returned for wildcard name queries.
-IncludeDependencies SwitchParameter optional: Include dependency resources exposed by repository metadata.
-Name String[] optionalposition: 0pipeline: True (ByValue, ByPropertyName)aliases: ModuleName: Module names or wildcard patterns to find. When omitted, all module package names are considered.
-Prerelease SwitchParameter optionalaliases: AllowPrerelease: Include prerelease versions.
-ProfileName String optional: Saved module repository profile to use instead of Repository.
-Proxy Uri optional: Optional HTTP proxy used for repository requests.
-ProxyCredential PSCredential optional: Optional proxy credential used with Proxy.
-Repository String optionalposition: 1aliases: RepositoryUri, Source: Repository URL, NuGet v3 service index, flat-container URL, or local folder feed.
-RepositoryName String optional: Friendly repository name used in output.
-ResourceType String[] optionalaliases: Type: Resource kind to find. Find-ManagedModule currently returns module resources.; Possible values: Module
-Tag String[] optionalaliases: Tags: Filter results by package tag metadata.
-Version String optional: Exact version, wildcard version, or NuGet-style version range to return.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.