Install-PSResource

  • Referência
Módulo:
Microsoft.PowerShell.PSResourceGet

Instala recursos a partir de um repositório registado.

Syntax

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Este cmdlet instala recursos de um repositório registado para um caminho de instalação num computador. Por predefinição, o cmdlet não devolve nenhum objeto. Outros parâmetros permitem-lhe especificar o repositório, o âmbito e a versão de um recurso e suprimir pedidos de licença.

Este cmdlet combina as funções dos Install-Module cmdlets e Install-Script do PowerShellGet v2.

Exemplos

Exemplo 1

Instala a versão estável (sem pré-lançamento) mais recente do módulo Az .

Install-PSResource Az

Exemplo 2

Instala o módulo Az estável mais recente entre versões 7.3.0 e 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Exemplo 3

Instala a versão estável mais recente do módulo Az . Quando o parâmetro Reinstalar é utilizado, o cmdlet escreve sobre qualquer versão instalada anteriormente.

Install-PSResource Az -Reinstall

Exemplo 4

Instala as PSResources especificadas no ficheiro psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemplo 5

Instala as PSResources especificadas na tabela hash.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parâmetros

-AcceptLicense

Especifica que o recurso deve aceitar qualquer pedido de aceitação do contrato de licença. Isto suprime o pedido se o módulo ordenar que um utilizador aceite o contrato de licença.

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

-AuthenticodeCheck

Valida assinaturas authenticode e ficheiros de catálogo no Windows.

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

-Confirm

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

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

-Credential

Credenciais opcionais utilizadas ao aceder a um repositório.

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

-InputObject

Utilizado para entrada de pipeline.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

O nome de um ou mais recursos a instalar.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoClobber

Impede a instalação de um pacote que contém cmdlets que já existem no computador.

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

-PassThru

Quando especificado, produz um objeto PSResourceInfo para o recurso guardado.

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

-Prerelease

Quando especificado, inclui versões de pré-lançamento nos resultados da pesquisa devolvidos.

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

-Quiet

Suprime a barra de progresso da instalação.

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

-Reinstall

Instala a versão mais recente de um módulo, mesmo que a versão mais recente já esteja instalada. A versão instalada é substituída. Isto permite-lhe reparar uma instalação danificada do módulo.

Se estiver instalada uma versão mais antiga do módulo, a nova versão será instalada lado a lado numa nova pasta específica da versão.

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

-Repository

Especifica um ou mais nomes de repositórios a procurar. Se não for especificado, a pesquisa inclui todos os repositórios registados, por ordem de prioridade (primeiro mais alto), até ser encontrado um repositório que contenha o pacote. Os repositórios são ordenados por prioridade e, em seguida, pelo nome. Os valores de Prioridade Inferior têm uma precedência superior.

Ao procurar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios com esta sequência de ordenação. Install-PSResource instala o primeiro pacote correspondente a partir da lista ordenada de repositórios.

O parâmetro suporta o * caráter universal. Se especificar vários repositórios, todos os nomes têm de incluir ou omitir o caráter universal. Não pode especificar uma combinação de nomes com e sem carateres universais.

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

-RequiredResource

Uma cadeia de carateres hash ou JSON que especifica os recursos a instalar. Os carateres universais não são permitidos. Consulte a secção NOTAS para obter uma descrição dos formatos de ficheiro.

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

-RequiredResourceFile

Caminho para um .psd1 ou .json que especifica os recursos a instalar. Os carateres universais não são permitidos. Consulte a secção NOTAS para obter uma descrição dos formatos de ficheiro.

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

-Scope

Especifica o âmbito de instalação. Os valores aceites são:

  • CurrentUser
  • AllUsers

O âmbito predefinido é CurrentUser, que não requer elevação para instalação.

O AllUsers âmbito instala módulos numa localização acessível a todos os utilizadores do computador. Por exemplo:

  • $env:ProgramFiles\PowerShell\Modules

O CurrentUser instala módulos numa localização acessível apenas ao utilizador atual do computador. Por exemplo:

  • $home\Documents\PowerShell\Modules
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

Ignora a verificação de dependências de recursos. Só são instalados recursos encontrados. Não são instalados recursos do recurso encontrado.

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

-TemporaryPath

Especifica o caminho para instalar temporariamente o recurso antes da instalação real. Se não for fornecido nenhum caminho temporário, o recurso será temporariamente instalado na pasta temporária do utilizador atual.

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

-TrustRepository

Suprima pedidos para confiar no repositório. O pedido para confiar no repositório só ocorre se o repositório não estiver configurado como fidedigno.

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

-Version

Especifica a versão do recurso a devolver. O valor pode ser uma versão exata ou um intervalo de versões com a sintaxe de controlo de versões NuGet.

Para obter mais informações sobre os intervalos de versões do NuGet, veja Controlo de versões do pacote.

O PowerShellGet suporta todas as versões inclusivas mínimas listadas na documentação do intervalo de versões NuGet. Utilizar 1.0.0.0 como a versão não produz as versões 1.0.0.0 e superior (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para procurar um intervalo inclusivo mínimo, utilize [1.0.0.0, ] como intervalo de versões.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Por predefinição, o cmdlet não devolve objetos. Quando o parâmetro PassThru é utilizado, o cmdlet produz um objeto PSResourceInfo para o recurso guardado.

Notas

O módulo define isres como um alias para Install-PSResource.

Os parâmetros RequiredResource e RequiredResourceFile são utilizados para localizar objetos PSResource que correspondam a critérios específicos. Pode especificar os critérios de pesquisa com uma tabela hash ou um objeto JSON. Para o parâmetro RequiredResourceFile , a tabela hash é armazenada num .psd1 ficheiro e o objeto JSON é armazenado num .json ficheiro. Para obter mais informações, veja about_PSResourceGet.