Find-ManagedModule

Namespace PSPublishModule

Inputs

System.String[]

Outputs

PowerForge.ManagedModuleVersionInfo

Finds module versions from a managed module repository.

Remarks

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

Authored help example

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

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.

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

Parameters

AllVersions SwitchParameter optionalposition: namedpipeline: False: Return all matching versions instead of only the latest selected version.
Credential PSCredential optionalposition: namedpipeline: False: Optional repository credential.
CredentialSecret String optionalposition: namedpipeline: Falsealiases: Password, Token: Optional repository credential secret.
CredentialSecretFilePath String optionalposition: namedpipeline: Falsealiases: CredentialPath, TokenPath: Optional path to a file containing the repository credential secret.
CredentialUserName String optionalposition: namedpipeline: Falsealiases: UserName: Optional repository credential username.
First Int32 optionalposition: namedpipeline: False: Maximum search results returned for wildcard name queries.
IncludeDependencies SwitchParameter optionalposition: namedpipeline: False: 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 optionalposition: namedpipeline: Falsealiases: AllowPrerelease: Include prerelease versions.
ProfileName String optionalposition: namedpipeline: False: Saved module repository profile to use instead of Repository.
Proxy Uri optionalposition: namedpipeline: False: Optional HTTP proxy used for repository requests.
ProxyCredential PSCredential optionalposition: namedpipeline: False: Optional proxy credential used with Proxy.
Repository String optionalposition: 1pipeline: Falsealiases: RepositoryUri, Source: Repository URL, NuGet v3 service index, flat-container URL, or local folder feed.
RepositoryName String optionalposition: namedpipeline: False: Friendly repository name used in output.
ResourceType String[] optionalposition: namedpipeline: Falsealiases: Typevalues: 1: Resource kind to find. Find-ManagedModule currently returns module resources.; Possible values: Module
Tag String[] optionalposition: namedpipeline: Falsealiases: Tags: Filter results by package tag metadata.
Version String optionalposition: namedpipeline: False: Exact version, wildcard version, or NuGet-style version range to return.

Outputs

PowerForge.ManagedModuleVersionInfo