Save-Script
Sintaxe
NameAndPathParameterSet (Predefinição)
Save-Script
[-Name] <String[]>
[-Path] <String>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameAndLiteralPathParameterSet
Save-Script
[-Name] <String[]>
-LiteralPath <String>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Script
[-InputObject] <PSObject[]>
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Script
[-InputObject] <PSObject[]>
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Save-Script cmdlet salva o script especificado.
Exemplos
Neste exemplo, um script de um repositório é salvo no computador local e os metadados do script são validados.
Save-Script -Name Install-VSCode -Repository PSGallery -Path C:\Test\Scripts
Test-ScriptFileInfo -Path C:\Test\Scripts\Install-VSCode.ps1
Version Name Author Description
------- ---- ------ -----------
1.3 Install-VSCode Microsoft This script can be used to easily install Visual Studio Code
Save-Script usa o parâmetro Name para especificar o nome do script. O parâmetro Repository especifica onde encontrar o script. O script é salvo no local especificado pelo parâmetro Path .
Test-ScriptFileInfo especifica o caminho e valida os metadados do script.
Parâmetros
-AcceptLicense
Aceite automaticamente o contrato de licença se o script o exigir.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AllowPrerelease
Permite salvar um script marcado como pré-lançamento.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar Save-Script.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: False
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Credential
Especifica uma conta de usuário que tem permissão para salvar um script.
Propriedades dos parâmetros
Tipo: PSCredential
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-Force
Força Save-Script a executar sem pedir a confirmação do usuário.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
Aceita um objeto PSRepositoryItemInfo . Por exemplo, a saída a uma variável e use essa variável como o argumento InputObject.
Tipo: PSObject [ ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
InputObjectAndLiteralPathParameterSet
Position: 0
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
InputObjectAndPathParameterSet
Position: 0
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-LiteralPath
Especifica um caminho para um ou mais locais. O valor do parâmetro LiteralPath é usado exatamente como inserido. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. O PowerShell não interpreta nenhum caractere entre aspas simples como sequências de escape.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: PSPath
Conjuntos de parâmetros
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
InputObjectAndLiteralPathParameterSet
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-MaximumVersion
Especifica a versão máxima ou mais recente do script a ser salva. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-MinimumVersion
Especifica a versão mínima de um script a ser salvo. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-Name
Especifica uma matriz de nomes de script para salvar.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: 0
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: 0
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-Path
Especifica o local no computador local para armazenar um módulo salvo. Aceita caracteres curinga.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: True
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: 1
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
InputObjectAndPathParameterSet
Position: 1
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-Proxy
Especifica um servidor proxy para a solicitação, em vez de se conectar diretamente a um recurso da Internet.
Propriedades dos parâmetros
Tipo: Uri
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-ProxyCredential
Especifica uma conta de usuário que tem permissão para usar o servidor proxy especificado pelo parâmetro Proxy .
Propriedades dos parâmetros
Tipo: PSCredential
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-Repository
Especifica o nome amigável de um repositório que foi registrado executando Register-PSRepositoryo . Use Get-PSRepository para exibir repositórios registrados.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-RequiredVersion
Especifica o número exato da versão do script a ser salvo.
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NameAndPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
NameAndLiteralPathParameterSet
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se Save-Script corresse. O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: False
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
Notas
Importante
A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Para obter mais informações, consulte o de anúncio de no blog do PowerShell.