Save-PSResource
Zapisuje zasoby (moduły i skrypty) z zarejestrowanego repozytorium na maszynie.
Składnia
Save-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-IncludeXml]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-Quiet]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-Quiet]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-IncludeXml]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-Quiet]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
To polecenie cmdlet łączy funkcje poleceń cmdlet Save-Module
i Save-Script
z PowerShellGet v2.
Save-PSResource
pobiera zasób z zarejestrowanego repozytorium do określonej ścieżki na komputerze lokalnym. Domyślnie zasób jest zapisywany w rozpakowanym lub zainstalowanym formacie. Skrypty lub moduły mogą być uruchamiane z zapisanej lokalizacji. Istnieje również możliwość pobrania zasobu w formacie .nupkg
.
Przykłady
Przykład 1
Pobiera moduł Az z repozytorium o najwyższym priorytcie i zapisuje go w bieżącej lokalizacji.
Save-PSResource -Name Az
Przykład 2
Pobiera moduł Az z galerii programu PowerShell i zapisuje go w bieżącej lokalizacji.
Save-PSResource -Name Az -Repository PSGallery
Przykład 3
Pobiera moduł Az z repozytorium o najwyższym priorytcie i zapisuje go w formacie .nupkg
w bieżącej lokalizacji.
Save-PSResource Az -AsNupkg
Przykład 4
Pobiera moduł Az z repozytorium o najwyższym priorytcie i zawiera plik metadanych PowerShellGet XML.
Save-PSResource Az -IncludeXML
Parametry
-AcceptLicense
W przypadku modułów, które wymagają licencji, automatycznie akceptuje umowę licencyjną podczas instalacji.
Ten parametr został dodany w pliku PSResourceGet 1.1.0-rc1.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AsNupkg
Zapisuje zasób jako plik .nupkg
.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AuthenticodeCheck
Sprawdza poprawność podpisanych plików i plików wykazu zasobu 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 |
-IncludeXml
Zawiera kod XML metadanych PowerShellGet używany do sprawdzania, czy moduł PowerShellGet został zainstalowany.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | False |
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 |
-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 |
-Path
Określa ścieżkę do zapisania zasobu. Jeśli nie podano żadnej ścieżki, zasób zostanie zapisany w bieżącym katalogu.
Typ: | String |
Position: | Named |
Domyślna wartość: | current directory |
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 dane wyjściowe paska postępu.
Ten parametr został dodany w pliku PSResourceGet 1.1.0-rc1.
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 Save-PSResource
zapisuje 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 |
-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 zapisaniem. 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[]
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