Install-PSResource

Módulo:

Microsoft.PowerShell.PSResourceGet Module

Instala recursos de um repositório registrado.

Sintaxe

NameParameterSet (Predefinição)

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

Descrição

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 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 duas novas funcionalidades:

• Sensibilização sobre a Plataforma e o Framework Target

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

• Suporte para $PSUserContentPath

  PSResourceGet agora respeita a variável automática do PowerShell, $PSUserContentPath. Esta variável automática será adicionada numa futura versão do PowerShell 7.7.0. O PowerShell preenche esta 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 por baixo 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 mantêm-se inalteradas. O PSResourceGet não analisa variáveis de ambiente nem powershell.config.json diretamente. O PowerShell detém a precedência de configuração e a expansão das variáveis de ambiente, depois expõe o valor resolvido da sessão através de $PSUserContentPath.

Exemplos

Exemplo 1

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

Install-PSResource Az -Repository PSGallery

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

Exemplo 2

Instala o mais recente módulo estável Az 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 versão estável mais recente 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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AuthenticodeCheck

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	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 o cmdlet.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Cf.

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Credential

Credenciais opcionais usadas ao acessar um repositório.

Propriedades dos parâmetros

Tipo:	PSCredential
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-InputObject

Usado para entrada de pipeline.

Propriedades dos parâmetros

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	ParentResource

Conjuntos de parâmetros

InputObjectParameterSet

Posto:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Name

O nome de um ou mais recursos a serem instalados.

Propriedades dos parâmetros

Tipo:	String[]
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

NameParameterSet

Posto:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-NoClobber

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-PassThru

Quando especificado, gera uma objeto de PSResourceInfo para o recurso salvo.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Prerelease

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	IsPrerelease

Conjuntos de parâmetros

NameParameterSet

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Quiet

Suprime a barra de progresso da instalação.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 tiver uma versão mais antiga do módulo instalada, a nova versão é instalada lado a lado numa pasta específica da nova versão.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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. Valores de de prioridade de mais baixos têm uma precedência maior.

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.

Propriedades dos parâmetros

Tipo:	String[]
Valor predefinido:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

NameParameterSet

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

InputObjectParameterSet

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

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

Propriedades dos parâmetros

Tipo:	Object
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

RequiredResourceParameterSet

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

RequiredResourceFileParameterSet

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-RuntimeIdentifier

Especifica o Identificador de Tempo de Execução (RID) para filtrar ativos específicos da plataforma. Quando especificado, o comando instala apenas os ativos de runtime que correspondem a este RID em vez da plataforma detetada automaticamente. Pode usar isto para cenários de implementação multiplataforma, por exemplo, ao preparar 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 dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 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 apenas ao usuário atual do computador. Por exemplo:

• $home\Documents\PowerShell\Modules

Propriedades dos parâmetros

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valor predefinido:	None
Valores aceites:	CurrentUser, AllUsers
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 este TFM em vez do framework autodetectado. Pode usar isto para cenários de implementação multiplataforma, por exemplo, ao preparar 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 dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 Versionamento 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 o intervalo de versões.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

NameParameterSet

Posto:	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 o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Wi

Conjuntos de parâmetros

(All)

Posto:	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.

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 usas o parâmetro PassThru , o cmdlet gera 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 usados para localizar objetos PSResource que correspondam 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 arquivo e o objeto JSON é armazenado em um arquivo . Para obter mais informações, consulte about_PSResourceGet.

Ligações Relacionadas

• Versionamento de pacote
• Uninstall-PSResource
• Estruturas de destino em projetos no estilo SDK
• Catálogo do .NET Runtime Identifier (RID)