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 |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
Weryfikuje podpisy Authenticode i pliki wykazu w systemie Windows.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Opcjonalne poświadczenia używane podczas uzyskiwania dostępu do repozytorium.
Typ: | PSCredential |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Służy do wprowadzania potoku.
Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nazwa co najmniej jednego zasobu do zainstalowania.
Typ: | String[] |
Position: | 0 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
Uniemożliwia zainstalowanie pakietu zawierającego polecenia cmdlet, które już istnieją na maszynie.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Po określeniu parametr zwraca obiekt PSResourceInfo dla zapisanego zasobu.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
Po określeniu parametr zawiera wersje wstępne w zwracanych wynikach wyszukiwania.
Typ: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
Pomija pasek postępu instalacji.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
akceptowane wartości: | CurrentUser, AllUsers |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
wartość domyślna: | False |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
String[]
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.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla