From 3de0e2d2e9499ef8a37c9905d1f72a3cef827e23 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Mon, 17 Mar 2025 13:26:52 -0500 Subject: [PATCH] Add note about NuGetv3 protocol limitation for dependencies (#204) --- .../Compress-PSResource.md | 2 +- .../Find-PSResource.md | 2 +- .../Get-InstalledPSResource.md | 2 +- .../Get-PSResourceRepository.md | 2 +- .../Get-PSScriptFileInfo.md | 2 +- .../Import-PSGetRepository.md | 2 +- .../Install-PSResource.md | 17 +++++++++++++---- .../Microsoft.PowerShell.PSResourceGet.md | 2 +- .../New-PSScriptFileInfo.md | 2 +- .../Publish-PSResource.md | 2 +- .../Register-PSResourceRepository.md | 2 +- .../Save-PSResource.md | 2 +- .../Set-PSResourceRepository.md | 2 +- .../Test-PSScriptFileInfo.md | 2 +- .../Uninstall-PSResource.md | 2 +- .../Unregister-PSResourceRepository.md | 2 +- .../Update-PSModuleManifest.md | 2 +- .../Update-PSResource.md | 2 +- .../Update-PSScriptFileInfo.md | 2 +- 19 files changed, 31 insertions(+), 22 deletions(-) diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md index 159625f..c2811e4 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/compress-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md index ef6a610..ae0270c 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/find-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md index c256279..9c6151c 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-installedpsresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md index be254aa..0de5c36 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md index a816d2f..b2dbd39 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md index a9d0621..8a8ffa4 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/import-psgetrepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md index 78d4843..f65e3bd 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md @@ -1,8 +1,8 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 -ms.date: 10/31/2024 +ms.custom: 1.1.0 +ms.date: 03/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/install-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- @@ -64,16 +64,25 @@ This cmdlet combines the functions of the `Install-Module` and `Install-Script` import the new version or start a new session to use the updated module. For more information, see [Import-Module](xref:Microsoft.PowerShell.Core.Import-Module). +> [!NOTE] +> `Install-PSResource` doesn't install dependent resources from repositories that use the NuGet v3 +> protocol. You must install the dependent resources individually. We intend to add this feature in +> a future release. + ## EXAMPLES ### Example 1 -Installs the latest stable (non-prerelease) version of the **Az** module. +Installs the latest stable (non-prerelease) version of the **Az** module from the PowerShell +Gallery. ```powershell -Install-PSResource Az +Install-PSResource Az -Repository PSGallery ``` +The Az module is a meta-module that includes all the Az PowerShell modules as dependencies. This +command installs the Az module and all its dependencies. + ### Example 2 Installs the latest stable **Az** module within the between versions `7.3.0` and `8.3.0`. diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md index ad200b6..3e22f93 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md @@ -4,7 +4,7 @@ Help Version: 3.0.24260 Locale: en-US Module Guid: e4e0bda1-0703-44a5-b70d-8fe704cd0643 Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 schema: 2.0.0 title: Microsoft.PowerShell.PSResourceGet diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md index c39c02f..1f85ead 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/new-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md index bdbe2b5..00e6a28 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/publish-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md index 80a5411..d043369 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/register-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md index 2c4fec2..8dbd3aa 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/save-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md index 4a8a4ac..e57ed27 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/set-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md index f2a8c79..6236813 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/test-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md index 2d81bbc..c2dcfcf 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/uninstall-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md index b6f73a7..2d27950 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/unregister-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md index c4ddef6..cf5d9cb 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/update-psmodulemanifest?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md index 759523f..928b03e 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/update-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md index 1dc8b15..3270eed 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md @@ -1,7 +1,7 @@ --- external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml Module Name: Microsoft.PowerShell.PSResourceGet -ms.custom: 1.1.0-rc2 +ms.custom: 1.1.0 ms.date: 10/31/2024 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/update-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0