Partilhar via

Install-PSResource

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

Instala recursos de um repositório registrado.

Sintaxe

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 registrado em um caminho de instalação em uma máquina. Por padrão, o cmdlet não retorna nenhum objeto. Outros parâmetros permitem especificar o repositório, o escopo e a versão de um recurso e suprimir prompts de licença.

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

Install-PSResource não carrega o módulo recém-instalado na sessão atual. Você deve importar a nova versão ou iniciar uma nova sessão para usar o módulo atualizado. Para obter mais informações, consulte Import-Module.

Exemplos

Exemplo 1

Instala a última versão estável (não pré-lançamento) do módulo Az .

Install-PSResource Az

Exemplo 2

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

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

Exemplo 3

Instala a última versão estável do módulo Az . Quando o parâmetro Reinstall é usado, o cmdlet grava sobre qualquer versão instalada anteriormente.

Install-PSResource Az -Reinstall

Exemplo 4

Instala o PSResources especificado no arquivo psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemplo 5

Instala o PSResources especificado na hashtable.

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 solicitação para aceitar o contrato de licença. Isso suprime a solicitação se o módulo exigir que um usuário aceite o contrato de licença.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AuthenticodeCheck

Valida assinaturas Authenticode e arquivos de catálogo no Windows.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Credenciais opcionais usadas ao acessar um repositório.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Usado para entrada de pipeline.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome de um ou mais recursos a serem instalados.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoClobber

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

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Quando especificado, gera uma saída de um objeto PSResourceInfo para o recurso salvo.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Prerelease

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

Tipo:SwitchParameter
Aliases:IsPrerelease
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Quiet

Suprime a barra de progresso da instalação.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 uma versão mais antiga do módulo estiver instalada, a nova versão será instalada lado a lado em uma nova pasta específica da versão.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Repository

Especifica um ou mais nomes de repositório para pesquisar. Se não for especificado, a pesquisa inclui todos os repositórios registrados, em ordem de prioridade (mais alta primeiro), até que seja encontrado um repositório que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Os valores de Prioridade Inferior têm uma precedência mais elevada.

Ao pesquisar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios usando essa ordem de classificação. Install-PSResource Instala o primeiro pacote correspondente da lista classificada de repositórios.

O parâmetro suporta o caractere curinga * . Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Não é possível especificar uma combinação de nomes com e sem curingas.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-RequiredResource

Uma hashtable ou cadeia de caracteres JSON que especifica recursos a serem instalados. Caracteres curinga não são permitidos. Consulte a seção NOTAS para obter uma descrição dos formatos de arquivo.

Tipo:Object
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RequiredResourceFile

Caminho para um .psd1 ou .json que especifica recursos a serem instalados. Caracteres curinga não são permitidos. Consulte a seção NOTAS para obter uma descrição dos formatos de arquivo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

Especifica o escopo da instalação. Os valores aceites são:

  • CurrentUser
  • AllUsers

O escopo padrão é CurrentUser, que não requer elevação para instalação.

O AllUsers escopo instala módulos em um local acessível a todos os usuários do computador. Por exemplo:

  • $env:ProgramFiles\PowerShell\Modules

O CurrentUser instala módulos em um local acessível apenas para o usuário atual do computador. Por exemplo:

  • $home\Documents\PowerShell\Modules
Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceites:CurrentUser, AllUsers
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkipDependencyCheck

Ignora a verificação de dependências de recursos. Apenas os recursos encontrados são instalados. Nenhum recurso do recurso encontrado está instalado.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TemporaryPath

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TrustRepository

Suprimir prompts para confiar no repositório. O prompt para confiar no repositório só ocorre se o repositório não estiver configurado como confiável.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Version

Especifica a versão do recurso a ser retornado. O valor pode ser uma versão exata ou um intervalo de versões usando a sintaxe de controle de versão do NuGet.

Para obter mais informações sobre intervalos de versões do NuGet, consulte Controle de versão de pacotes.

O PowerShellGet suporta todas, exceto a versão mínima inclusiva listada na documentação do intervalo de versões do NuGet. Usar 1.0.0.0 como a versão não produz versões 1.0.0.0 e superiores (intervalo mínimo inclusivo). Em vez disso, o valor é considerado a versão necessária. Para procurar um intervalo mínimo inclusivo, use [1.0.0.0, ] como intervalo de versões.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Por padrão, o cmdlet não retorna nenhum objeto. Quando o parâmetro PassThru é usado, o cmdlet gera um objeto PSResourceInfo para o recurso salvo.

Notas

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

Os parâmetros RequiredResource e RequiredResourceFile são usados para localizar objetos PSResource que correspondem a critérios específicos. Você pode especificar os critérios de pesquisa usando uma hashtable ou um objeto JSON. Para o parâmetro RequiredResourceFile , a hashtable é armazenada em um .psd1 arquivo e o objeto JSON é armazenado em um .json arquivo. Para obter mais informações, consulte about_PSResourceGet.