Partilhar via

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]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet 

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

RequiredResourceFileParameterSet 

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet 

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-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 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.

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
Default value:False
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

-AuthenticodeCheck

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
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

-Confirm

Solicita confirmação antes de executar o cmdlet.

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

Credenciais opcionais usadas ao acessar um repositório.

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:False
Valor dos restantes argumentos:False

-InputObject

Usado para entrada de pipeline.

Propriedades dos parâmetros

Tipo:

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ParentResource

Conjuntos de parâmetros

InputObjectParameterSet
Position: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[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NameParameterSet
Position: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
Default value:False
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

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
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

-Prerelease

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:IsPrerelease

Conjuntos de parâmetros

NameParameterSet
Position: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
Default value:False
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

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
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

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

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

NameParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
InputObjectParameterSet
Position: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
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

RequiredResourceParameterSet
Position: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
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

RequiredResourceFileParameterSet
Position:Named
Obrigatório:True
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
Default value:None
Valores aceites:CurrentUser, AllUsers
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

-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
Default value:False
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

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

-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
Default value:False
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

-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
Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

NameParameterSet
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 o cmdlet fosse executado. 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.

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 uma objeto de 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 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.