Save-Module

Zapisuje moduł i jego zależności na komputerze lokalnym, ale nie instaluje modułu.

Składnia

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie Save-Module cmdlet pobiera moduł i wszystkie zależności z zarejestrowanego repozytorium. Save-Module pobiera i zapisuje najnowszą wersję modułu. Pliki są zapisywane w określonej ścieżce na komputerze lokalnym. Moduł nie jest zainstalowany, ale zawartość jest dostępna do inspekcji przez administratora. Zapisany moduł można następnie skopiować do odpowiedniej $env:PSModulePath lokalizacji maszyny w trybie offline.

Get-PSRepository Wyświetla zarejestrowane repozytoria komputera lokalnego. Możesz użyć Find-Module polecenia cmdlet , aby wyszukać zarejestrowane repozytoria.

Przykłady

Przykład 1. Zapisywanie modułu

W tym przykładzie moduł i jego zależności są zapisywane na komputerze lokalnym.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

Save-Module używa parametru Name do określenia modułu PowerShellGet. Parametr Path określa miejsce przechowywania pobranego modułu. Parametr Repository określa zarejestrowane repozytorium PSGallery. Po zakończeniu pobierania wyświetla zawartość ścieżki, Get-ChildItem w której są przechowywane pliki.

Przykład 2. Zapisywanie określonej wersji modułu

W tym przykładzie pokazano, jak użyć parametru, takiego jak MaximumVersion lub RequiredVersion , aby określić wersję modułu.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

Save-Module używa parametru Name do określenia modułu PowerShellGet. Parametr Path określa miejsce przechowywania pobranego modułu. Parametr Repository określa zarejestrowane repozytorium PSGallery. MaximumVersion określa, że wersja 2.1.0 jest pobierana i zapisywana. Po zakończeniu pobierania wyświetla zawartość ścieżki, Get-ChildItem w której są przechowywane pliki.

Przykład 3. Znajdowanie i zapisywanie określonej wersji modułu

W tym przykładzie wymagana wersja modułu zostanie znaleziona w repozytorium i zapisana na komputerze lokalnym.

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

Find-Module używa parametru Name do określenia modułu PowerShellGet. Parametr Repository określa zarejestrowane repozytorium PSGallery. RequiredVersion określa wersję 1.6.5.

Obiekt jest wysyłany w dół potoku do .Save-Module Parametr Path określa miejsce przechowywania pobranego modułu. Po zakończeniu pobierania wyświetla zawartość ścieżki, Get-ChildItem w której są przechowywane pliki.

Parametry

-AcceptLicense

Automatycznie zaakceptuj umowę licencyjną, jeśli pakiet go wymaga.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrerelease

Umożliwia zapisanie modułu oznaczonego jako wydanie wstępne.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia Save-Module.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Określa konto użytkownika, które ma uprawnienia do zapisania modułu.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Force

Jeśli lokalizacja określona przez parametr Path nie istnieje, polecenie cmdlet zwróci błąd. Użycie parametru Force powoduje utworzenie ścieżki docelowej.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Akceptuje obiekt PSRepositoryItemInfo . Na przykład dane wyjściowe Find-Module do zmiennej i użyj tej zmiennej jako argumentu InputObject .

Type:PSObject[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Określa ścieżkę do co najmniej jednej lokalizacji. Wartość parametru LiteralPath jest używana dokładnie tak, jak wprowadzono. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy je ująć w znaki pojedynczego cudzysłowu. Program PowerShell nie interpretuje żadnych znaków ujętych w pojedynczy cudzysłów jako sekwencje ucieczki.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Określa maksymalną lub najnowszą wersję modułu do zapisania. Nie można użyć parametrów MaximumVersion i RequiredVersion w tym samym poleceniu.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MinimumVersion

Określa minimalną wersję pojedynczego modułu do zapisania. Nie można dodać tego parametru, jeśli próbujesz zainstalować wiele modułów. Parametrów MinimumVersion i RequiredVersion nie można użyć w tym samym poleceniu.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa tablicę nazw modułów do zapisania.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Określa lokalizację na komputerze lokalnym do przechowywania zapisanego modułu. Akceptuje symbole wieloznaczne.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Proxy

Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy, który jest określony przez parametr proxy .

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Określa przyjazną nazwę repozytorium, które zostało zarejestrowane przez uruchomienie polecenia Register-PSRepository. Służy Get-PSRepository do wyświetlania zarejestrowanych repozytoriów.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Określa dokładny numer wersji modułu do zapisania.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie, jeśli przebiegi zostaną uruchomione Save-Module . Polecenie cmdlet nie jest uruchamiane.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String[]

PSObject[]

String

Uri

PSCredential

Dane wyjściowe

Object

Uwagi

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.