Share via

Install-PSResource

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

Instala recursos de um repositório registrado.

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

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 que você especifique o repositório, o escopo e a versão de um recurso e suprima os prompts de licença.

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

Exemplos

Exemplo 1

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

Install-PSResource Az

Exemplo 2

Instala o módulo Az estável mais recente dentro do 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 é gravado 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.

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

-AuthenticodeCheck

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

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

-Confirm

Solicita 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 usadas ao acessar um repositório.

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

-InputObject

Usado 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 serem instalados.

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, gera um objeto PSResourceInfo para o recurso salvo.

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

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

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ório a serem pesquisados. Se não for especificado, a pesquisa incluirá 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. Os valores de Prioridade Mais Baixa têm uma precedência mais alta.

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

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

-RequiredResource

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

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 recursos a serem instalados. Caracteres curinga não são permitidos. Consulte a seção ANOTAÇÕES para obter uma descrição dos formatos de arquivo.

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

-Scope

Especifica o escopo da instalação. Os valores aceitos 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 somente para o usuário 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 o marcar para dependências de recursos. Somente os recursos encontrados estão instalados. Nenhum recurso encontrado está instalado.

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 nenhum caminho temporário for fornecido, o recurso será instalado temporariamente na pasta temporária do usuário atual.

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

-TrustRepository

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

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 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 Controle de versão do pacote.

O PowerShellGet dá suporte a todas, exceto à 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.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. 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 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.

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