Udostępnij za pośrednictwem

Publish-PSResource

  • Odwołanie
Moduł:
Microsoft.PowerShell.PSResourceGet

Publikuje określony moduł z komputera lokalnego do repozytorium PSResource.

Składnia

Publish-PSResource
       [-ApiKey <String>]
       [-Repository <String>]
       [-Path] <String>
       [-DestinationPath <String>]
       [-Credential <PSCredential>]
       [-SkipDependenciesCheck]
       [-SkipModuleManifestValidate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-PSResource
       [-ApiKey <String>]
       [-Repository <String>]
       [-DestinationPath <String>]
       [-Credential <PSCredential>]
       [-SkipDependenciesCheck]
       [-SkipModuleManifestValidate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       -NupkgPath <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Opis

To polecenie cmdlet łączy funkcje poleceń cmdlet Publish-Module i Publish-Script z PowerShellGet v2. Publish-PSResource publikuje zasób z komputera lokalnego do repozytorium opartego na nuGet online. Zasób można określić według ścieżki zawierającej pliki zasobów modułu lub skryptu albo wskazując wstępnie spakowany plik .nupkg.

Przykłady

Przykład 1

W tym przykładzie moduł TestModule do repozytorium zarejestrowanego z najwyższym priorytetem.

Publish-PSResource -Path c:\TestModule

Przykład 2

W tym przykładzie moduł TestModule w galerii programu PowerShell. Klucz interfejsu API to wpis tajny generowany przez galerię programu PowerShell dla konta użytkownika.

Publish-PSResource -Path c:\TestModule -Repository PSGallery -APIKey '1234567'

Przykład 3

Ten przykład publikuje moduł Nupkg TestModule.nupkg do repozytorium o nazwie TestRepository.

Publish-PSResource -NupkgPath c:\TestModule.nupkg -Repository TestRepository

Parametry

-ApiKey

Określa klucz interfejsu API, którego chcesz użyć do opublikowania zasobu w galerii online.

Typ:String
Position:Named
Domyślna wartość:None
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

Określa konto użytkownika, które ma prawa do określonego repozytorium.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestinationPath

Określa ścieżkę, w której ma zostać zapisany plik pakietu NuGet .nupkg. Ten parametr może być używany w połączeniu z parametrem Repository do publikowania w repozytorium, a także zapisywania dokładnie tego samego pakietu w lokalnym systemie plików.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ModulePrefix

Jest to parametr dynamiczny, który jest dostępny tylko w wierszu polecenia, gdy podano parametr ścieżki lub Nupkg oraz parametr repozytorium dla repozytorium ContainerRegistry.

Wartość parametru jest wstępnie wpięta do nazwy pakietu. Te informacje są używane tylko do publikowania i nie są uwzględniane w metadanych pakietu. Prefiks modułu kontroluje widoczność modułu, na przykład: internal, public, staging.

Ten parametr jest używany tylko podczas publikowania w rejestrze Microsoft Artifact Registry (MAR).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NupkgPath

Ścieżka do pliku .nupkg do opublikowania. Plik .nupkg mógł zostać utworzony przez poprzedni przebieg Publish-PSResource z parametrem DestinationPath. Możesz też utworzyć plik .nupkg za pomocą polecenia Compress-PSResource.

Ten parametr został dodany w wersji 1.1.0-preview2 Microsoft.PowerShell.PSResourceGet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Ścieżka do pliku modułu lub skryptu albo ścieżka do folderu zawierającego plik modułu lub skryptu do opublikowania. Polecenie cmdlet pakuje wszystkie pliki w folderze do pliku .nupkg przed opublikowaniem w repozytorium.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Proxy

Adres URL serwera proxy używany do uzyskiwania dostępu do repozytoriów spoza sieci.

Typ:Uri
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProxyCredential

Poświadczenia wymagane do korzystania z serwera proxy.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Repository

Określa repozytorium do opublikowania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipDependenciesCheck

Pomija domyślne sprawdzanie, czy wszystkie zależności znajdują się w repozytorium docelowym.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipModuleManifestValidate

Pomija walidację manifestu modułu przed opublikowaniem.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-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

None

Dane wyjściowe

Uwagi

Moduł definiuje pbres jako alias dla Publish-PSResource.

Repozytorium oparte na udziałach plików nie ma metadanych dotyczących zasobów. W związku z tym nie ma możliwości sprawdzania zależności.