Install-PSResource

Odwołanie

Moduł:: Microsoft.PowerShell.PSResourceGet

Instaluje zasoby z zarejestrowanego repozytorium.

Składnia

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

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

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-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.

Nuta

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.

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ą.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-AuthenticodeCheck

Weryfikuje podpisy Authenticode i pliki wykazu w systemie Windows.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Credential

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

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Służy do wprowadzania potoku.

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliasy:	ParentResource
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Name

Nazwa co najmniej jednego zasobu do zainstalowania.

Typ:	String[]
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-NoClobber

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-PassThru

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Prerelease

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

Typ:	SwitchParameter
Aliasy:	IsPrerelease
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Quiet

Pomija pasek postępu instalacji.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 zainstalowano starszą wersję modułu, nowa wersja zostanie zainstalowana obok siebie w nowym folderze specyficznym dla wersji.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	True

-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.

Typ:	Object
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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. Na przykład:

$env:ProgramFiles\PowerShell\Modules

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

$home\Documents\PowerShell\Modules

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Dopuszczalne wartości:	CurrentUser, AllUsers
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SkipDependencyCheck

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-TrustRepository

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	True

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

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 jest używany parametr PassThru, polecenie cmdlet zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Uwagi

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.

Udostępnij za pośrednictwem

Install-PSResource

Składnia

Opis

Przykłady

Przykład 1

Przykład 2

Przykład 3

Przykład 4

Przykład 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Install-PSResource

Składnia

Opis

Przykłady

Przykład 1

Przykład 2

Przykład 3

Przykład 4

Przykład 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby