Add Microsoft.WinGet.Client PowerShell Module files

.github/actions/spelling/expect.txt

@@ -1,7 +1,6 @@
 abcd
 accepteula
 adjacents
-activatable
 adml
 admx
 affle
@@ -20,7 +19,6 @@ apicontract
 apiset
 appinstallertest
 appname
-Archs
 arget
 argumentlist
 ARMNT
@@ -56,6 +54,7 @@ BOMs
 boundparms
 brk
 Buf
+buildtransitive
 BUILTINS
 cancelledbyuser
 casemap
@@ -81,6 +80,7 @@ COMGLB
 commandline
 Concat
 contactsupport
+contentfiles
 contoso
 contractversion
 count'th
@@ -103,20 +103,22 @@ diskfull
 dllimport
 dnld
 Dobbeleer
-dsc
+Dsc
+Dst
 dustojnikhummer
 dvinns
 dw
+ebug
 ecfr
 ecfrbrowse
-efgh
+EFGH
 endian
-enr
 enums
 EQU
 ERANGE
 errno
 ESRB
+estination
 etest
 execustom
 EXEHASH
@@ -139,18 +141,16 @@ FULLMUTEX
 FULLWIDTH
 fundraiser
 fuzzer
-FWW
 fzanollo
 gcpi
 GES
 GESMBH
 GHS
 gitlab
 gity
-Globals
 Google
 guiddef
-hackathon
+Hackathon
 hashtable
 helplib
 helplibrary
@@ -162,8 +162,8 @@ hmodule
 hre
 hresults
 htm
-IAttachment
 IARP
+IAttachment
 IConfiguration
 idx
 IFACEMETHODIMP
@@ -214,6 +214,7 @@ learnxinyminutes
 lhs
 libsolv
 libyaml
+Lifecycle
 Linq
 liv
 liwpx
@@ -226,7 +227,6 @@ LPWSTR
 LSTATUS
 LTDA
 lw
-lww
 lz
 malware
 maxvalue
@@ -236,8 +236,8 @@ megamorf
 memcpy
 middleware
 midl
-minidump
 minexample
+minidump
 minschema
 missingdependency
 MMmmbbbb
@@ -258,7 +258,6 @@ myinstalldir
 mylog
 mysilent
 mysilentwithprogress
-mytool
 NETFX
 netlify
 Newtonsoft
@@ -278,12 +277,10 @@ objbase
 objidl
 ofile
 Outptr
-OSVERSION
-Packagedx
 packageinuse
-parametermap
+PARAMETERMAP
+paramref
 pathparts
-pathpaths
 Patil
 pb
 PCs
@@ -303,6 +300,7 @@ pri
 processthreads
 productcode
 pscustomobject
+psd
 pseudocode
 psm
 psobject
@@ -361,6 +359,7 @@ standalone
 startswith
 streambuf
 strtoull
+stylecop
 subdir
 subkey
 superstring
@@ -369,7 +368,6 @@ SUSE
 swervy
 SYD
 SYG
-symlink
 sysrefcomp
 Tagit
 TCpp
@@ -388,6 +386,7 @@ TResult
 trimstart
 TState
 TStatus
+typeof
 UCase
 ucasemap
 UChars
@@ -396,7 +395,7 @@ uec
 uild
 uintptr
 ul
-Uninitialize
+uninitialize
 uninstallation
 uninstaller
 uninstallprevious
@@ -425,13 +424,12 @@ vscode
 vstest
 vy
 wcslen
-WDAG
 webpages
 Webserver
 website
 WERSJA
 wesome
-whatif
+Whatif
 windir
 windowsdeveloper
 winerror
@@ -441,7 +439,6 @@ winreg
 withstarts
 wn
 Workflows
-wsb
 wsl
 wsv
 wto

src/AppInstallerCLI.sln

@@ -136,6 +136,10 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "COMServer", "COMServer\COMS
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "Microsoft.Management.Deployment.InProc", "Microsoft.Management.Deployment.InProc\Microsoft.Management.Deployment.InProc.vcxproj", "{9AC3C6A4-1875-4D3E-BF9C-C31E81EFF6B4}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "PowerShell", "PowerShell", "{7C218A3E-9BC8-48FF-B91B-BCACD828C0C9}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Microsoft.WinGet.Client", "PowerShell\Microsoft.WinGet.Client\Microsoft.WinGet.Client.csproj", "{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}"
+EndProject
 Global
 	GlobalSection(SharedMSBuildProjectFiles) = preSolution
 		ManifestSchema\ManifestSchema.vcxitems*{1622da16-914f-4f57-a259-d5169003cc8c}*SharedItemsImports = 4
@@ -1026,6 +1030,46 @@ Global
 		{9AC3C6A4-1875-4D3E-BF9C-C31E81EFF6B4}.TestRelease|x64.Build.0 = Release|x64
 		{9AC3C6A4-1875-4D3E-BF9C-C31E81EFF6B4}.TestRelease|x86.ActiveCfg = Release|Win32
 		{9AC3C6A4-1875-4D3E-BF9C-C31E81EFF6B4}.TestRelease|x86.Build.0 = Release|Win32
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|Any CPU.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|Any CPU.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|ARM.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|ARM.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|ARM64.ActiveCfg = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|ARM64.Build.0 = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|x64.ActiveCfg = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|x64.Build.0 = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|x86.ActiveCfg = Debug|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Debug|x86.Build.0 = Debug|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|Any CPU.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|Any CPU.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|ARM.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|ARM.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|ARM64.ActiveCfg = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|ARM64.Build.0 = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|x64.ActiveCfg = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|x64.Build.0 = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|x86.ActiveCfg = Debug|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Fuzzing|x86.Build.0 = Debug|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|Any CPU.ActiveCfg = Release|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|Any CPU.Build.0 = Release|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|ARM.ActiveCfg = Release|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|ARM.Build.0 = Release|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|ARM64.ActiveCfg = Release|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|ARM64.Build.0 = Release|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|x64.ActiveCfg = Release|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|x64.Build.0 = Release|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|x86.ActiveCfg = Release|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.Release|x86.Build.0 = Release|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|Any CPU.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|Any CPU.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|ARM.ActiveCfg = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|ARM.Build.0 = Debug|ARM
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|ARM64.ActiveCfg = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|ARM64.Build.0 = Debug|ARM64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|x64.ActiveCfg = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|x64.Build.0 = Debug|x64
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|x86.ActiveCfg = Debug|x86
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C}.TestRelease|x86.Build.0 = Debug|x86
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -1045,6 +1089,7 @@ Global
 		{866C3F06-636F-4BE8-BC24-5F86ECC606A1} = {60618CAC-2995-4DF9-9914-45C6FC02C995}
 		{1A47951F-5C7A-4D6D-BB5F-D77484437940} = {8D53D749-D51C-46F8-A162-9371AAA6C2E7}
 		{409CD681-22A4-469D-88AE-CB5E4836E07A} = {8D53D749-D51C-46F8-A162-9371AAA6C2E7}
+		{463C0EF3-DF38-4C3D-8E7E-D4901E0CDC6C} = {7C218A3E-9BC8-48FF-B91B-BCACD828C0C9}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {B6FDB70C-A751-422C-ACD1-E35419495857}

src/PowerShell/Microsoft.WinGet.Client/Attributes/FilterAttribute.cs

@@ -0,0 +1,23 @@
+// -----------------------------------------------------------------------------
+// <copyright file="FilterAttribute.cs" company="Microsoft Corporation">
+//     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
+// </copyright>
+// -----------------------------------------------------------------------------
+
+namespace Microsoft.WinGet.Client.Attributes
+{
+    using System;
+    using Microsoft.Management.Deployment;
+
+    /// <summary>
+    /// Marking a property with this attribute causes it to be added to the filters list when searching for packages.
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
+    public class FilterAttribute : Attribute
+    {
+        /// <summary>
+        /// Gets or sets the field that the filter will be matching against.
+        /// </summary>
+        public PackageMatchField Field { get; set; }
+    }
+}

src/PowerShell/Microsoft.WinGet.Client/BuildModule.ps1

@@ -0,0 +1,38 @@
+# Copyright (c) Microsoft Corporation. Licensed under the MIT License.
+
+[CmdletBinding()]
+param (
+    [Parameter()]
+    $In = "$PSScriptRoot\bin",
+
+    [Parameter()]
+    [string]
+    $Out = "$PSScriptRoot\build\bin",
+
+    [Parameter()]
+    [string]
+    $Configuration = 'Release'
+)
+
+$CoreFramework = 'net6.0-windows10.0.22000.0'
+$DesktopFramework = 'net461'
+
+if (Test-Path $Out) {
+    Remove-Item $Out -Recurse
+}
+
+Get-ChildItem $In -ErrorAction SilentlyContinue -Exclude 'Debug','Release' | ForEach-Object {
+    Write-Verbose ($_.FullName)
+
+    $coreSrcPath = Join-Path $_.FullName $Configuration $CoreFramework
+    $coreDstPath = Join-Path $Out $_.Name 'Core'
+    $desktopSrcPath = Join-Path $_.FullName $Configuration $DesktopFramework
+    $desktopDstPath = Join-Path $Out $_.Name 'Desktop'
+
+    Copy-Item $coreSrcPath -Destination $coreDstPath -Recurse -Force
+    Copy-Item $desktopSrcPath -Destination $desktopDstPath -Recurse -Force
+}
+
+Copy-Item 'Format.ps1xml' -Destination $Out
+Copy-Item 'Microsoft.WinGet.Client.psd1' -Destination $Out
+Copy-Item 'Microsoft.WinGet.Client.psm1' -Destination $Out

src/PowerShell/Microsoft.WinGet.Client/Commands/BaseClientCommand.cs

@@ -0,0 +1,69 @@
+// -----------------------------------------------------------------------------
+// <copyright file="BaseClientCommand.cs" company="Microsoft Corporation">
+//     Copyright (c) Microsoft Corporation. Licensed under the MIT License.
+// </copyright>
+// -----------------------------------------------------------------------------
+
+namespace Microsoft.WinGet.Client.Commands
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Management.Automation;
+    using System.Security.Principal;
+    using Microsoft.Management.Deployment;
+    using Microsoft.WinGet.Client.Factories;
+
+    /// <summary>
+    /// This is the base class for all commands in this module.
+    /// </summary>
+    public class BaseClientCommand : PSCmdlet
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="BaseClientCommand"/> class.
+        /// </summary>
+        public BaseClientCommand()
+            : base()
+        {
+            var identity = WindowsIdentity.GetCurrent();
+            var principal = new WindowsPrincipal(identity);
+            var admin = principal.IsInRole(WindowsBuiltInRole.Administrator);
+            if (admin)
+            {
+                throw new Exception(@"This cmdlet is currently not available in an administrator context.");
+            }
+        }
+
+        /// <summary>
+        /// Gets the instance of the <see cref="ComObjectFactory" /> class.
+        /// </summary>
+        protected static Lazy<ComObjectFactory> ComObjectFactory { get; } = new Lazy<ComObjectFactory>();
+
+        /// <summary>
+        /// Gets the instance of the <see cref="PackageManager" /> class.
+        /// </summary>
+        protected static Lazy<PackageManager> PackageManager { get; } = new Lazy<PackageManager>(() => ComObjectFactory.Value.CreatePackageManager());
+
+        /// <summary>
+        /// Retrieves the specified source or all sources if <paramref name="source" /> is null.
+        /// </summary>
+        /// <returns>A list of <see cref="PackageCatalogReference" /> instances.</returns>
+        /// <param name="source">The name of the source to retrieve. If null, then all sources are returned.</param>
+        /// <exception cref="ArgumentException">The source does not exist.</exception>
+        protected static IReadOnlyList<PackageCatalogReference> GetPackageCatalogReferences(string source)
+        {
+            if (source is null)
+            {
+                return PackageManager.Value.GetPackageCatalogs();
+            }
+            else
+            {
+                return new List<PackageCatalogReference>()
+                {
+                    PackageManager.Value.GetPackageCatalogByName(source)
+                        ?? throw new ArgumentException("No sources match the given value: " + source),
+                };
+            }
+        }
+
+    }
+}