Udostępnij za pośrednictwem


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.

Jest to polecenie cmdlet serwera proxy dla Save-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Save-PSResource

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

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Save-PSResourceprogram .

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

-AllowPrerelease

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

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr wersji wstępnej polecenia Save-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Save-PSResourceprogram .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:True
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.

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr Path .Save-PSResource

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

-MaximumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version .Save-PSResource

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

-MinimumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version .Save-PSResource

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

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
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
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Proxy

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Save-PSResourceprogram .

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

-ProxyCredential

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez Save-PSResourceprogram .

Type:PSCredential
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequiredVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version .Save-PSResource

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String[]

PSObject[]

String

Uri

PSCredential

Dane wyjściowe

Object

Uwagi

Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Należy użyć protokołu TLS 1.2 lub nowszego. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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