Publish-Script

Referência

Módulo:: PowerShellGet

Publica um script.

Sintaxe

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>]

Description

O Publish-Script cmdlet publica o script especificado na galeria online.

Este é um cmdlet proxy para o Publish-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Publish-PSResource.

Exemplos

Exemplo 1: criar um arquivo de script, adicionar conteúdo a ele e publicá-lo

O New-ScriptFileInfo cmdlet cria um arquivo de script chamado Demo-Script.ps1. Get-Content exibe o conteúdo de Demo-Script.ps1. O Add-Content cmdlet adiciona uma função e um fluxo de trabalho a Demo-Script.ps1.

$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

O Test-ScriptFileInfo cmdlet valida Demo-Script.ps1. O Publish-Script cmdlet publica o script no repositório LocalRepo1 . Finalmente. Find-Script é usado para pesquisar Demo-Script.ps1 no repositório LocalRepo1 .

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Credential

Tipo:	PSCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Force

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Publish-PSResource.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-LiteralPath

Especifica um caminho para um ou mais locais. Ao contrário do parâmetro Path , o valor do parâmetro LiteralPath é usado exatamente como inserido. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. Aspas simples dizem ao Windows PowerShell para não interpretar nenhum caractere como sequências de escape.

O parâmetro é mapeado para o parâmetro Path do Publish-PSResource cmdlet.

Tipo:	String
Aliases:	PSPath
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-NuGetApiKey

Especifica a chave de API que você deseja usar para publicar um script na galeria online. A chave de API faz parte do seu perfil na galeria online. Para obter mais informações, consulte Gerenciando chaves de API.

O parâmetro é mapeado para o parâmetro ApiKey do Publish-PSResource cmdlet.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

Especifica um caminho para um ou mais locais. Caracteres curinga são permitidos. O local padrão é o diretório atual.

Tipo:	String
Cargo:	Named
Valor padrão:	<Current location>
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	True

-Repository

Especifica o nome amigável de um repositório que foi registrado executando Register-PSRepository.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

PSCredential

Saídas

Object

Observações

A Galeria do PowerShell não dá mais suporte a TLS (Transport Layer Security) versões 1.0 e 1.1. Você deve usar o TLS 1.2 ou superior. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:

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

Compartilhar via