Publish-Script

  • Odwołanie
Moduł:
PowerShellGet

Publikuje skrypt.

Składnia

Publish-Script
       -Path <String>
       [-NuGetApiKey <String>]
       [-Repository <String>]
       [-Credential <PSCredential>]
       [-Force]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-Script
       -LiteralPath <String>
       [-NuGetApiKey <String>]
       [-Repository <String>]
       [-Credential <PSCredential>]
       [-Force]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Opis

Polecenie Publish-Script cmdlet publikuje określony skrypt w galerii online.

To jest polecenie cmdlet serwera proxy dla Publish-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Publish-PSResource (Publikowanie w usłudze PSResource).

Przykłady

Przykład 1. Tworzenie pliku skryptu, dodawanie do niego zawartości i publikowanie go

Polecenie New-ScriptFileInfo cmdlet tworzy plik skryptu o nazwie Demo-Script.ps1. Get-Content wyświetla zawartość elementu Demo-Script.ps1. Polecenie Add-Content cmdlet dodaje funkcję i przepływ pracy do Demo-Script.ps1polecenia .

$newScriptInfo = @{
  Path = 'D:\ScriptSharingDemo\Demo-Script.ps1'
  Version = '1.0'
  Author = 'author@contoso.com'
  Description = "my test script file description goes here"
}
New-ScriptFileInfo @newScriptInfo
Get-Content -Path $newScriptInfo.Path

<#PSScriptInfo

.VERSION 1.0

.AUTHOR pattif@microsoft.com

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES
#>

<#
.DESCRIPTION
 my test script file description goes here
#>
Param()

Add-Content -Path D:\ScriptSharingDemo\Demo-Script.ps1 -Value @"

Function Demo-ScriptFunction { 'Demo-ScriptFunction' }

Workflow Demo-ScriptWorkflow { 'Demo-ScriptWorkflow' }

Demo-ScriptFunction
Demo-ScriptWorkflow
"@
Test-ScriptFileInfo -Path D:\ScriptSharingDemo\Demo-Script.ps1

Version    Name                 Author                   Description
-------    ----                 ------                   -----------
1.0        Demo-Script          author@contoso.com       my test script file description goes here

Publish-Script -Path D:\ScriptSharingDemo\Demo-Script.ps1 -Repository LocalRepo1
Find-Script -Repository LocalRepo1 -Name "Demo-Script"

Version    Name                 Type       Repository    Description
-------    ----                 ----       ----------    -----------
1.0        Demo-Script          Script     LocalRepo1    my test script file description goes here

Polecenie Test-ScriptFileInfo cmdlet weryfikuje polecenie Demo-Script.ps1. Polecenie Publish-Script cmdlet publikuje skrypt w repozytorium LocalRepo1 . I na koniec. Find-Script służy do wyszukiwania Demo-Script.ps1 w repozytorium LocalRepo1 .

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

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 Publish-PSResourceprogram .

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

-LiteralPath

Określa ścieżkę do co najmniej jednej lokalizacji. W przeciwieństwie do parametru Path 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 pojedynczy cudzysłów. Znaki pojedynczego cudzysłowu informują, Windows PowerShell nie interpretować żadnych znaków jako sekwencji ucieczki.

Parametr jest mapowany na parametr Publish-PSResourcePath polecenia cmdlet.

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

-NuGetApiKey

Określa klucz interfejsu API, którego chcesz użyć do opublikowania skryptu w galerii online. Klucz interfejsu API jest częścią twojego profilu w galerii online. Aby uzyskać więcej informacji, zobacz Zarządzanie kluczami interfejsu API.

Parametr jest mapowany na parametr Publish-PSResourceApiKey polecenia cmdlet.

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

-Path

Określa ścieżkę do co najmniej jednej lokalizacji. Dozwolone są symbole wieloznaczne. Domyślna lokalizacja to bieżący katalog.

Type:String
Position:Named
Default value:<Current location>
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Repository

Określa przyjazną nazwę repozytorium, które zostało zarejestrowane przez uruchomienie polecenia Register-PSRepository.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

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