Udostępnij za pośrednictwem


Install-PSResource

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 Install-Module poleceń cmdlet i Install-Script z modułu PowerShellGet w wersji 2.

Install-PSResource program 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.

Przykłady

Przykład 1

Instaluje najnowszą stabilną (inną niż wersja wstępna) wersję modułu Az .

Install-PSResource Az

Przykład 2

Instaluje najnowszy stabilny 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 Ponowne instalowanie, 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. Wartości niższego priorytetu mają wyższy priorytet.

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

Parametr obsługuje * symbol 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. Zobacz sekcję UWAGI , aby uzyskać opis formatów plików.

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

-RequiredResourceFile

Ścieżka do elementu .psd1 lub .json określająca zasoby do zainstalowania. Symbole wieloznaczne nie są dozwolone. Zobacz sekcję UWAGI , aby uzyskać opis formatów plików.

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

Moduły CurrentUser są instalowane 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 nuGet, zobacz Przechowywanie wersji pakietów.

Moduł PowerShellGet obsługuje wszystkie, 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.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 po uruchomieniu polecenia cmdlet. 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 elementu 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 tabela skrótu jest przechowywana w .psd1 pliku, a obiekt JSON jest przechowywany w .json pliku. Aby uzyskać więcej informacji, zobacz about_PSResourceGet.