Install-PSResource

Moduł:

Microsoft.PowerShell.PSResourceGet Module

Instaluje zasoby z zarejestrowanego repozytorium.

Składnia

NameParameterSet (domyślnie)

Install-PSResource
    [-Name] <string[]>
    [-Version <string>]
    [-Prerelease]
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <string>
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

To polecenie cmdlet instaluje zasoby z zarejestrowanego repozytorium do ścieżki instalacji na maszynie. Domyślnie polecenie cmdlet nie zwraca żadnego obiektu. Inne parametry umożliwiają określenie repozytorium, zakresu i wersji zasobu oraz pomijanie monitów o licencję.

To polecenie cmdlet łączy funkcje poleceń cmdlet Install-Module i Install-Script z PowerShellGet v2.

Install-PSResource nie ładuje nowo zainstalowanego modułu do bieżącej sesji. Musisz zaimportować nową wersję lub uruchomić nową sesję, aby użyć zaktualizowanego modułu. Aby uzyskać więcej informacji, zobacz Import-Module.

Uwaga / Notatka

Install-PSResource nie instaluje zasobów zależnych z repozytoriów korzystających z protokołu NuGet w wersji 3. Zasoby zależne należy zainstalować osobno. Zamierzamy dodać tę funkcję w przyszłej wersji.

Począwszy od PSResourceGet v1.3.0-preview2, dodaje dwie nowe funkcje:

• Świadomość Platform i Ram Docelowych

  Domyślnie cmdlet Install-PSResource instaluje teraz tylko komponenty specyficzne dla platformy i ramy docelowe zasobu. To nowe zachowanie zmniejsza rozmiar zainstalowanego zasobu, zajmując mniej miejsca na dysku. Ta wersja dodaje także dwa nowe parametry: **RuntimeIdentifier** oraz TargetFramework, które pozwalają określić platformę i docelowy framework instalacji, gdy jest to potrzebne.

• Obsługa $PSUserContentPath

  PSResourceGet teraz respektuje automatyczną zmienną PowerShell, $PSUserContentPath. Ta automatyczna zmienna zostanie dodana w przyszłej wersji PowerShell 7.7.0. PowerShell wypełnia tę zmienną rozwiązaną ścieżką dla treści CurrentUser. Gdy $PSUserContentPath zawiera użyteczny ciąg znaków, PSResourceGet instaluje moduły i skrypty CurrentUser pod tą ścieżką. Gdy zmienna jest niedostępna lub pusta, PSResourceGet zachowuje istniejącą, platformowo specyficzną ścieżkę CurrentUser . Moduł AllUsers i lokalizacje skryptów pozostają bez zmian. PSResourceGet nie analizuje zmiennych środowiskowych ani powershell.config.json bezpośrednio. PowerShell posiada priorytet konfiguracji i rozszerzenie zmiennych środowiskowych, a następnie udostępnia wartość sesji rozwiązanej przez $PSUserContentPath.

Przykłady

Przykład 1

Instaluje najnowszą stabilną wersję modułu Az z galerii programu PowerShell.

Install-PSResource Az -Repository PSGallery

Moduł Az to meta-moduł zawierający wszystkie moduły az programu PowerShell jako zależności. To polecenie instaluje moduł Az i wszystkie jego zależności.

Przykład 2

Instaluje najnowszą stabilną moduł Az w ramach między wersjami 7.3.0 i 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Przykład 3

Instaluje najnowszą stabilną wersję modułu Az. Gdy jest używany parametr ponownej instalacji, polecenie cmdlet zapisuje wszystkie wcześniej zainstalowane wersje.

Install-PSResource Az -Reinstall

Przykład 4

Instaluje pliki PSResources określone w pliku psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Przykład 5

Instaluje pliki PSResources określone w tabeli skrótów.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parametry

-AcceptLicense

Określa, że zasób powinien zaakceptować każde żądanie zaakceptowania umowy licencyjnej. Spowoduje to pominięcie monitowania, jeśli moduł nakazuje, aby użytkownik zaakceptował umowę licencyjną.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-AuthenticodeCheck

Weryfikuje podpisy Authenticode i pliki wykazu w systemie Windows.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Credential

Opcjonalne poświadczenia używane podczas uzyskiwania dostępu do repozytorium.

Właściwości parametru

Typ:	PSCredential
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-InputObject

Służy do wprowadzania potoku.

Właściwości parametru

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Zasób nadrzędny

Zestawy parametrów

InputObjectParameterSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Name

Nazwa co najmniej jednego zasobu do zainstalowania.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	0
Obowiązkowe:	True
Wartość z potoku:	True
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-NoClobber

Uniemożliwia zainstalowanie pakietu zawierającego polecenia cmdlet, które już istnieją na maszynie.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-PassThru

Po określeniu parametr zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Prerelease

Po określeniu parametr zawiera wersje wstępne w zwracanych wynikach wyszukiwania.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	ISPrelease

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Quiet

Pomija pasek postępu instalacji.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Reinstall

Instaluje najnowszą wersję modułu, nawet jeśli jest już zainstalowana najnowsza wersja. Zainstalowana wersja jest zastępowana. Dzięki temu można naprawić uszkodzoną instalację modułu.

Jeśli masz zainstalowaną starszą wersję modułu, nowa wersja jest instalowana obok siebie w nowym folderze specyficznym dla konkretnej wersji.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Repository

Określa co najmniej jedną nazwę repozytorium do wyszukania. Jeśli nie zostanie określony, wyszukiwanie obejmuje wszystkie zarejestrowane repozytoria, w kolejności priorytetu (najwyższy pierwszy), dopóki repozytorium nie zostanie znalezione, które zawiera pakiet. Repozytoria są sortowane według priorytetu, a następnie według nazwy. Niższe wartości Priorytet mają wyższy priorytet.

Podczas wyszukiwania zasobów w wielu repozytoriach polecenia cmdlet PSResourceGet przeszukają repozytoria przy użyciu tej kolejności sortowania. Install-PSResource instaluje pierwszy pasujący pakiet z posortowanej listy repozytoriów.

Parametr obsługuje znak wieloznaczny *. Jeśli określisz wiele repozytoriów, wszystkie nazwy muszą zawierać lub pomijać symbol wieloznaczny. Nie można określić kombinacji nazw z symbolami wieloznacznymi i bez symboli wieloznacznych.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	True
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

InputObjectParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-RequiredResource

Wartość skrótu lub ciąg JSON, który określa zasoby do zainstalowania. Symbole wieloznaczne nie są dozwolone. Aby uzyskać opis formatów plików, zobacz sekcję NOTES.

Właściwości parametru

Typ:	Object
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

RequiredResourceParameterSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-RequiredResourceFile

Ścieżka do .psd1 lub .json, która określa zasoby do zainstalowania. Symbole wieloznaczne nie są dozwolone. Aby uzyskać opis formatów plików, zobacz sekcję NOTES.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

RequiredResourceFileParameterSet

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-RuntimeIdentifier

Określa identyfikator czasowy (RID) do filtrowania zasobów specyficznych dla platformy. Gdy jest to określone, polecenie instaluje tylko zasoby w czasie rzeczywistym odpowiadające temu RID, zamiast automatycznie wykrywanej platformy. Możesz wykorzystać to do scenariuszy wdrożenia na różnych platformach, na przykład przygotowując pakiet Linux z Windows. Polecenie obsługuje następujące wartości RID z katalogu .NET RID:

• linux-arm
• linux-arm64
• linux-musl-arm64
• linux-musl-x64
• linux-x64
• osx-arm64
• osx-x64
• win-arm64
• win-x64
• win-x86

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Scope

Określa zakres instalacji. Akceptowane wartości to:

• CurrentUser
• AllUsers

Domyślny zakres to CurrentUser, który nie wymaga podniesienia uprawnień do instalacji.

Zakres AllUsers instaluje moduły w lokalizacji dostępnej dla wszystkich użytkowników komputera. Przykład:

• $env:ProgramFiles\PowerShell\Modules

CurrentUser instaluje moduły w lokalizacji dostępnej tylko dla bieżącego użytkownika komputera. Przykład:

• $home\Documents\PowerShell\Modules

Właściwości parametru

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Domyślna wartość:	None
Dopuszczalne wartości:	CurrentUser, AllUsers
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-SkipDependencyCheck

Pomija sprawdzanie zależności zasobów. Zainstalowane są tylko znalezione zasoby. Nie zainstalowano żadnych zasobów znalezionych zasobów.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-TargetFramework

Określa nazwę Target Framework (TFM) do wyboru dla lib/ filtrowania folderów. Gdy jest to wskazane, polecenie instaluje tylko zasoby odpowiadające lib/ temu TFM, zamiast automatycznie wykrywanego frameworka. Możesz wykorzystać to do scenariuszy wdrożenia na różnych platformach, na przykład przygotowując pakiet Linux z Windows. Polecenie obsługuje następujące wartości TFM:

• net48
• net6.0
• net7.0
• net8.0
• net9.0
• net10.0
• netstandard2.0
• netstandard2.1

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-TemporaryPath

Określa ścieżkę do tymczasowego zainstalowania zasobu przed rzeczywistą instalacją. Jeśli nie podano ścieżki tymczasowej, zasób jest tymczasowo zainstalowany w folderze tymczasowym bieżącego użytkownika.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-TrustRepository

Pomijanie monitów o zaufanie repozytorium. Monit o zaufanie do repozytorium występuje tylko wtedy, gdy repozytorium nie jest skonfigurowane jako zaufane.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Version

Określa wersję zasobu, która ma zostać zwrócona. Wartość może być dokładną wersją lub zakresem wersji przy użyciu składni przechowywania wersji NuGet.

Aby uzyskać więcej informacji na temat zakresów wersji pakietu NuGet, zobacz Package versioning.

Moduł PowerShellGet obsługuje wszystkie elementy, ale minimalną wersję inkluzywną wymienioną w dokumentacji zakresu wersji NuGet. Użycie 1.0.0.0 jako wersji nie daje wersji 1.0.0.0 i wyższych (minimalny zakres włącznie). Zamiast tego wartość jest uważana za wymaganą wersję. Aby wyszukać minimalny zakres inkluzywny, użyj [1.0.0.0, ] jako zakresu wersji.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	True
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Domyślnie polecenie cmdlet nie zwraca żadnych obiektów. Gdy używasz parametru PassThru , cmdlet generuje obiekt PSResourceInfo dla zapisanego zasobu.

Notatki

Moduł definiuje isres jako alias dla Install-PSResource.

Parametry RequiredResource i RequiredResourceFile służą do znajdowania obiektów PSResource spełniających określone kryteria. Kryteria wyszukiwania można określić przy użyciu tabeli skrótu lub obiektu JSON. Dla parametru RequiredResourceFile wartość skrótu jest przechowywana w pliku .psd1, a obiekt JSON jest przechowywany w pliku .json. Aby uzyskać więcej informacji, zobacz about_PSResourceGet.

Linki powiązane

• Wersjonowanie pakietów
• Uninstall-PSResource
• Docelowe platformy w projektach w stylu SDK
• Katalog identyfikatora środowiska uruchomieniowego platformy .NET (RID)