Install-PSResource

Modulo:

Microsoft.PowerShell.PSResourceGet Module

Installa le risorse da un repository registrato.

Sintassi

NameParameterSet (impostazione predefinita).

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

Descrizione

Questo cmdlet installa le risorse da un repository registrato in un percorso di installazione in un computer. Per impostazione predefinita, il cmdlet non restituisce alcun oggetto. Altri parametri consentono di specificare il repository, l'ambito e la versione per una risorsa e eliminare le richieste di licenza.

Questo cmdlet combina le funzioni dei cmdlet Install-Module e Install-Script da PowerShellGet v2.

Install-PSResource non carica il modulo appena installato nella sessione corrente. È necessario importare la nuova versione o avviare una nuova sessione per usare il modulo aggiornato. Per altre informazioni, vedere Import-Module.

Annotazioni

Install-PSResource non installa le risorse dipendenti dai repository che usano il protocollo NuGet v3. È necessario installare singolarmente le risorse dipendenti. Questa funzionalità verrà aggiunta in una versione futura.

Esempio

Esempio 1

Installa la versione stabile (non definitiva) più recente del modulo az di da PowerShell Gallery.

Install-PSResource Az -Repository PSGallery

Il modulo Az è un metamodulo che include tutti i moduli az di PowerShell come dipendenze. Questo comando installa il modulo Az e tutte le relative dipendenze.

Esempio 2

Installa il modulo stabile Az più recente all'interno di tra le versioni 7.3.0 e 8.3.0.

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

Esempio 3

Installa la versione stabile più recente del modulo az . Quando si usa il parametro Reinstall, il cmdlet scrive su qualsiasi versione installata in precedenza.

Install-PSResource Az -Reinstall

Esempio 4

Installa psResources specificato nel file psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Esempio 5

Installa le risorse PSResources specificate nella tabella hash.

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 = @{}
}

Parametri

-AcceptLicense

Specifica che la risorsa deve accettare qualsiasi richiesta di accettare il contratto di licenza. In questo modo viene eliminata la richiesta se il modulo impone a un utente di accettare il contratto di licenza.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-AuthenticodeCheck

Convalida le firme Authenticode e i file di catalogo in Windows.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Credential

Credenziali facoltative usate per l'accesso a un repository.

Proprietà dei parametri

Tipo:	PSCredential
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-InputObject

Usato per l'input della pipeline.

Proprietà dei parametri

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Risorsa genitore

Set di parametri

InputObjectParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Name

Nome di una o più risorse da installare.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

NameParameterSet

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-NoClobber

Impedisce l'installazione di un pacchetto che contiene cmdlet già esistenti nel computer.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-PassThru

Se specificato, restituisce un oggetto PSResourceInfo per la risorsa salvata.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Prerelease

Se specificato, include versioni non definitive nei risultati della ricerca restituiti.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	IsPrerelease

Set di parametri

NameParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Quiet

Elimina l'indicatore di stato dell'installazione.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Reinstall

Installa la versione più recente di un modulo anche se la versione più recente è già installata. La versione installata viene sovrascritta. In questo modo è possibile ripristinare un'installazione danneggiata del modulo.

Se è installata una versione precedente del modulo, la nuova versione viene installata side-by-side in una nuova cartella specifica della versione.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Repository

Specifica uno o più nomi di repository da cercare. Se non specificato, la ricerca include tutti i repository registrati, in ordine di priorità (il primo), fino a quando non viene trovato un repository che contiene il pacchetto. I repository vengono ordinati in base alla priorità e quindi in base al nome. I valori Priority lower hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet di PSResourceGet eseguono ricerche nei repository usando questo ordinamento. Install-PSResource installa il primo pacchetto corrispondente dall'elenco ordinato di repository.

Il parametro supporta il carattere jolly *. Se si specificano più repository, tutti i nomi devono includere o omettere il carattere jolly. Non è possibile specificare una combinazione di nomi con e senza caratteri jolly.

Proprietà dei parametri

Tipo:	String[]
Valore predefinito:	None
Supporta i caratteri jolly:	True
DontShow:	False

Set di parametri

NameParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

InputObjectParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-RequiredResource

Stringa hashtable o JSON che specifica le risorse da installare. I caratteri jolly non sono consentiti. Per una descrizione dei formati di file, vedere la sezione NOTES.

Proprietà dei parametri

Tipo:	Object
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

RequiredResourceParameterSet

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RequiredResourceFile

Percorso di un .psd1 o .json che specifica le risorse da installare. I caratteri jolly non sono consentiti. Per una descrizione dei formati di file, vedere la sezione NOTES.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

RequiredResourceFileParameterSet

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Scope

Specifica l'ambito di installazione. I valori accettati sono:

• CurrentUser
• AllUsers

L'ambito predefinito è CurrentUser, che non richiede l'elevazione dei privilegi per l'installazione.

L'ambito AllUsers installa i moduli in un percorso accessibile a tutti gli utenti del computer. Per esempio:

• $env:ProgramFiles\PowerShell\Modules

Il CurrentUser installa i moduli in un percorso accessibile solo all'utente corrente del computer. Per esempio:

• $home\Documents\PowerShell\Modules

Proprietà dei parametri

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valore predefinito:	None
Valori accettati:	CurrentUser, AllUsers
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-SkipDependencyCheck

Ignora il controllo delle dipendenze delle risorse. Vengono installate solo le risorse trovate. Non vengono installate risorse della risorsa trovata.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TemporaryPath

Specifica il percorso per installare temporaneamente la risorsa prima dell'installazione effettiva. Se non viene specificato alcun percorso temporaneo, la risorsa viene installata temporaneamente nella cartella temporanea dell'utente corrente.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TrustRepository

Elimina le richieste di attendibilità del repository. Il prompt per considerare attendibile il repository si verifica solo se il repository non è configurato come attendibile.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Version

Specifica la versione della risorsa da restituire. Il valore può essere una versione esatta o un intervallo di versioni usando la sintassi di controllo delle versioni di NuGet.

Per altre informazioni sugli intervalli di versioni di NuGet, vedere Controllo delle versioni dei pacchetti.

PowerShellGet supporta tutte le versioni incluse elencate nella documentazione dell'intervallo di versioni di NuGet. L'uso di 1.0.0.0 perché la versione non restituisce versioni 1.0.0.0 e successive (intervallo inclusivo minimo). Il valore viene invece considerato la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	True
DontShow:	False

Set di parametri

NameParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Per impostazione predefinita, il cmdlet non restituisce oggetti. Quando si usa il parametro PassThru, il cmdlet restituisce un oggetto PSResourceInfo per la risorsa salvata.

Note

Il modulo definisce isres come alias per Install-PSResource.

I parametri RequiredResource e RequiredResourceFile vengono usati per trovare oggetti PSResource corrispondenti a criteri specifici. È possibile specificare i criteri di ricerca usando una tabella hash o un oggetto JSON. Per il parametro RequiredResourceFile, la tabella hash viene archiviata in un file .psd1 e l'oggetto JSON viene archiviato in un file .json. Per altre informazioni, vedere about_PSResourceGet.

Collegamenti correlati

• Controllo delle versioni dei pacchetti
• Uninstall-PSResource