Managing Resources with PowerShellGet v3
The cmdlet names have changed in PowerShellGet v3. Instead of Install-Module
, you will use Install-PSResource
. It’s actually the same cmdlet for all resources such as scripts and DSC resources.
Install-PSResource -Name Universal
The Install-PSResource
cmdlet supports similar parameters to Install-Module
but have slightly different names and meanings.
For example, -AllowClobber
was optional in Install-Module
but is now the default for Install-PSResource
. You can use -NoClobber
to change this behavior.
Install-PSResource -Name dbatools -Version '1.1.41' -NoClobber
Changing Installation Scope
The -Scope
parameter can be used to install the module for CurrentUser
or AllUsers
. CurrentUser
is the default setting. You will need to be running as administrator to install to all users.
Install-PSResource -Name 'PSWindowsUpdate' -Scope AllUsers
Installing DSC Resources
You can also install DSC resources with Install-PSResource
. The syntax is very much the same as with modules.
Install-PSResource -Name 'NetworkingDsc'
Saving a Module
Much like Save-Module
, you can use Save-PSResource
to download a module for deployment to offline machines or to save into your own repository. Save-PSResource
supports parameters like -AsNupkg
and -IncludeXml
to change what is downloaded. NuPkg files are special ZIP files that contain manifest information and are used with the NuGet package management system.
Save-PSResource -Name Universal -AsNupkg -Path .\universal.nupkg
List Installed Modules
You can use Get-PSResource
to list modules, and other resources, that have been installed with PowerShellGet.
Get-PSResource
Uninstall a Module
You can use the Uninstall-PSResource
cmdlet to uninstall a module.
Uninstall-PSResource -Name Universal
Publish a Module
You can publish modules, an other resources, to repositories using Publish-PSResource
.
Publish-PSResource -Path .\universal -ApiKey 'Test'
Working with Repositories in PowerShellGet v3
By default, you will have the PowerShell Gallery defined as a repository. It will not be trusted but you can use the -TrustRepository
cmdlet on the *-PSResource
cmdlets to avoid the prompt to trust the repository.
Install-PSResource -Name 'PendingReboot' -TrustRepository
Trust a Repository
You can trust a repository by using the Set-PSResourceRepository
cmdlet. You won’t be prompted to trust the repository with each call from now on.
Set-PSResourceRepository -Name PSGallery -Trusted
Register a Repository
You can register a repository by using the Register-PSResourceRepository
cmdlet.
Register-PSResourceRepository -Name Local -URL \\server\share
To reverse the change, use Unregister-PSResourceRepository
.
Unregister-PSResourceRepository -Name Local
Find Resources with PowerShellGet v3
To find resources with PowerShellGet, you’ll use the Find-PSResource
cmdlet.
Find-PSResource -Name Universal
Find Resources by Type
You can specify the -Type
parameter to look for resources by type.
Find-PSResource -Name PSDscResources -Type DscResource
Find Resources by Tag
You can use the -Tag
parameter to look up resources with tags.
Find-PSResource -Tag universal-dashboard
Find Resources by Wildcard Search
You can also use wildcard searches to find resources that contain a pattern.
Find-PSResource -Name Universal*
Backwards Compatibility
Since PowerShellGet v2 and v3 are very different, the PowerShell team has released a compatibility module so that you can continue to use the original syntax and commands.
You’ll need to install the CompatPowerShellGet
module in order to use the previous commands with the new version of PowerShellGet.
Install-PSResource -Name CompatPowerShellGet
Now, you can use cmdlets like Install-Module
and it will map the command to Install-PSResource
automatically.
Install-Module -Name dbatools -AllowPrerelease
Internally, this executes the following.
Install-PSResource -Name dbatools -Prerelease
The command will work as expected but you will see a warning.
Install-Module -Name dbatools -AllowPrerelease
WARNING: The cmdlet 'Install-Module' is deprecated, please use 'Install-PSResource'.
- An Introduction of GitLab Duo - December 22, 2024
- Best Hospitals for affordable surgery for medical tourism - December 20, 2024
- Top Global Medical Tourism Companies in the World - December 20, 2024