Install-PSResource

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]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

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

RequiredResourceFileParameterSet

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

RequiredResourceParameterSet

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

Opis

Przykłady

Przykład 1

Install-PSResource Az -Repository PSGallery

Przykład 2

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

Przykład 3

Install-PSResource Az -Reinstall

Przykład 4

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Przykład 5

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 parametrów

Zestawy parametrów

-AuthenticodeCheck

Weryfikuje podpisy Authenticode i pliki wykazu w systemie Windows.

Właściwości parametrów

Zestawy parametrów

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Zestawy parametrów

-Credential

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

Właściwości parametrów

Zestawy parametrów

-InputObject

Służy do wprowadzania potoku.

Właściwości parametrów

Zestawy parametrów

-Name

Nazwa co najmniej jednego zasobu do zainstalowania.

Właściwości parametrów

Zestawy parametrów

-NoClobber

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

Właściwości parametrów

Zestawy parametrów

-PassThru

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

Właściwości parametrów

Zestawy parametrów

-Prerelease

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

Właściwości parametrów

Zestawy parametrów

-Quiet

Pomija pasek postępu instalacji.

Właściwości parametrów

Zestawy parametrów

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

Właściwości parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-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 parametrów

Zestawy parametrów

-WhatIf

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

Właściwości parametrów

Zestawy parametrów

CommonParameters

Wejścia

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Wyjść

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notatki

Powiązane linki

• Wersjonowanie pakietów
• Uninstall-PSResource