Install-PSResource

Módulo:

Microsoft.PowerShell.PSResourceGet Module

Instala recursos de um repositório registrado.

Sintaxe

NameParameterSet (Default)

Install-PSResource
    [-Name] <string[]>
    [-Version <string>]
    [-Prerelease]
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <string>
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <pscredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <string>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-RuntimeIdentifier <string>]
    [-TargetFramework <string>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Esse cmdlet instala recursos de um repositório registrado em um caminho de instalação em um computador. 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 os prompts de licença.

Esse cmdlet combina as funções dos cmdlets Install-Module 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 .

Observação

Install-PSResource não instala recursos dependentes de repositórios que usam o protocolo NuGet v3. Você deve instalar os recursos dependentes individualmente. Pretendemos adicionar esse recurso em uma versão futura.

A partir do PSResourceGet v1.3.0-preview2 adiciona dois novos recursos:

• Plataforma e Framework Target Consciência do Nome

  Por padrão, o Install-PSResource cmdlet agora instala apenas os componentes específicos da plataforma e do framework de destino de um recurso. Esse novo comportamento reduz o tamanho do recurso instalado, consumindo menos espaço em disco. Esta versão também adiciona dois novos parâmetros, **RuntimeIdentifier** e TargetFramework, que permitem especificar a plataforma e o framework de destino para a instalação quando necessário.

• Apoio para $PSUserContentPath

  PSResourceGet agora respeita a variável automática do PowerShell, $PSUserContentPath. Essa variável automática será adicionada em uma futura versão do PowerShell 7.7.0. O PowerShell preenche essa variável com o caminho resolvido para o conteúdo do CurrentUser. Quando $PSUserContentPath contém uma string utilizável, o PSResourceGet instala módulos e scripts CurrentUser abaixo desse caminho. Quando a variável está indisponível ou vazia, o PSResourceGet preserva o caminho CurrentUser específico da plataforma existente. As localizações do módulo AllUsers e dos scripts permanecem inalteradas. PSResourceGet não analisa variáveis de ambiente nem powershell.config.json diretamente. O PowerShell possui a precedência de configuração e a expansão da variável ambiental, então expõe o valor da sessão resolvida por meio de $PSUserContentPath.

Exemplos

Exemplo 1

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

Install-PSResource Az -Repository PSGallery

O módulo Az é um meta-módulo que inclui todos os módulos do Az PowerShell como dependências. Esse comando instala o módulo Az e todas as suas dependências.

Exemplo 2

Instala o módulo de estável mais recente do Az 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 é usado, o cmdlet grava em qualquer versão instalada anteriormente.

Install-PSResource Az -Reinstall

Exemplo 4

Instala os PSResources especificados no arquivo psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Exemplo 5

Instala os PSResources especificados no 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.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AuthenticodeCheck

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Credential

Credenciais opcionais usadas ao acessar um repositório.

Propriedades do parâmetro

Tipo:	PSCredential
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-InputObject

Usado para entrada de pipeline.

Propriedades do parâmetro

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	Recurso dos pais

Conjuntos de parâmetros

InputObjectParameterSet

Cargo:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Name

O nome de um ou mais recursos a serem instalados.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

NameParameterSet

Cargo:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-NoClobber

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PassThru

Quando especificado, gera um objeto PSResourceInfo para o recurso salvo.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Prerelease

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	ÉPré-lançamento

Conjuntos de parâmetros

NameParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-Quiet

Suprime a barra de progresso da instalação.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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. Isso permite que você repare uma instalação danificada do módulo.

Se você tiver uma versão mais antiga do módulo instalada, a nova versão é instalada lado a lado em uma pasta específica para cada versão.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Repository

Especifica um ou mais nomes de repositório a serem pesquisados. Se não for especificado, a pesquisa inclui todos os repositórios registrados, em ordem de prioridade (primeiro mais alto), até que um repositório seja encontrado que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Valores de de prioridade de inferiores têm uma precedência maior.

Ao pesquisar recursos em vários repositórios, os cmdlets de 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 dá suporte ao caractere curinga *. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Você não pode especificar uma combinação de nomes com e sem curingas.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	True
DontShow:	False

Conjuntos de parâmetros

NameParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

InputObjectParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-RequiredResource

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

Propriedades do parâmetro

Tipo:	Object
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

RequiredResourceParameterSet

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-RequiredResourceFile

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

RequiredResourceFileParameterSet

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-RuntimeIdentifier

Especifica o Identificador de Tempo de Execução (RID) para filtrar ativos específicos da plataforma para. Quando especificado, o comando instala apenas os ativos de runtime que correspondem a esse RID em vez da plataforma autodetectada. Você pode usar isso para cenários de implantação multiplataforma, por exemplo, preparando um pacote Linux a partir do Windows. O comando suporta os seguintes valores RID do catálogo .NET RID:

• linux-arm
• linux-arm64
• linux-musl-arm64
• linux-musl-x64
• linux-x64
• osx-arm64
• osx-x64
• win-arm64
• win-x64
• win-x86

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Scope

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

• CurrentUser
• AllUsers

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

O escopo AllUsers 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 somente ao usuário atual do computador. Por exemplo:

• $home\Documents\PowerShell\Modules

Propriedades do parâmetro

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valor padrão:	None
Valores aceitos:	CurrentUser, AllUsers
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SkipDependencyCheck

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-TargetFramework

Especifica o Target Framework Moniker (TFM) para selecionar para lib/ filtragem de pastas. Quando especificado, o comando instala apenas os lib/ ativos correspondentes a esse TFM em vez do framework autodetectado. Você pode usar isso para cenários de implantação multiplataforma, por exemplo, preparando um pacote Linux a partir do Windows. O comando suporta os seguintes valores TFM:

• net48
• net6.0
• net7.0
• net8.0
• net9.0
• net10.0
• netstandard2.0
• netstandard2.1

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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á temporariamente instalado na pasta temporária do usuário atual.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-TrustRepository

Suprimir solicitações para confiar no repositório. O prompt para confiar no repositório só ocorrerá se o repositório não estiver configurado como confiável.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Version

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

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

O PowerShellGet dá suporte a todas as versão inclusiva mínima listada na documentação do intervalo de versões do NuGet. Usar 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 pesquisar um intervalo inclusivo mínimo, use [1.0.0.0, ] como o intervalo de versão.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	True
DontShow:	False

Conjuntos de parâmetros

NameParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-WhatIf

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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.

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 você usa o parâmetro PassThru , o cmdlet gera um objeto PSResourceInfo para o recurso salvo.

Observações

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 um hashtable ou um objeto JSON. Para o parâmetro RequiredResourceFile, o hashtable é armazenado em um arquivo .psd1 e o objeto JSON é armazenado em um arquivo .json. Para obter mais informações, consulte about_PSResourceGet.

Links Relacionados

• Controle de versão do pacote
• Uninstall-PSResource
• Estruturas de destino em projetos no estilo SDK
• Catálogo de RID (Identificador de Runtime) do .NET.