Guida introduttiva

In questo argomento viene descritto come installare e configurare i moduli OCI per PowerShell.

Requisiti indispensabili

Assicurarsi di soddisfare tutti i requisiti elencati qui.

Installazione dei moduli

Avviare una sessione PowerShell:

In Windows, avviare PowerShell dal menu Start.

Su Linux o MacOS, eseguire pwsh da un prompt shell:

$ pwsh

PowerShell 7.1.0
Copyright (c) Microsoft Corporation. All rights reserved.

https://aka.ms/powershell
Type 'help' to get help.

PS /Users/username>

Per installare tutti i moduli OCI, installare il modulo base:

Install-Module OCI.PSModules

Nota

La disinstallazione del modulo OCI.PSModules non disinstallerà altri moduli OCI. Per disinstallare un modulo OCI specifico installato da questo modulo, è necessario prima disinstallare il modulo OCI.PSModules.
È possibile installare solo i moduli per un singolo servizio. I cmdlet corrispondenti a ciascun servizio OCI supportato dai moduli OCI per PowerShell vengono inseriti in un singolo modulo Powershell denominato OCI.PSModules.<ServiceName>.
Passare a Installazione da Galleria PowerShell o Installazione da GitHub.

Installazione dalla Galleria PowerShell

Per impostazione predefinita, PowerShell Gallery ("Galleria PS") è configurato come PSRepository. Questo può essere verificato eseguendo il comando Get-PSRepository:

PS /> Get-PSRepository
 
Name                      InstallationPolicy   SourceLocation
----                      ------------------   --------------
PSGallery                 Untrusted            https://www.powershellgallery.com/api/v2

È possibile impostare PS Gallery come repository attendibile per evitare richieste ogni volta che si tenta di installare un modulo da PS Gallery:
```
PS /> Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
```
I moduli PowerShell che corrispondono a un servizio OCI supportato sono chiamati moduli di servizio. Per installare un modulo di servizio, eseguire il comando Install-Module. In questo esempio viene installato il modulo di servizio per il servizio OCI Identity:
```
PS /> Install-Module -Name OCI.PSModules.Identity
```
Nota

Ciascun modulo di servizio dipende dal modulo OCI.PSModules.Common (Common Module), che offre funzionalità comuni a tutti i moduli di servizio. L'installazione di un modulo di servizio installerà anche la versione corrispondente di OCI.PSModules.Common per tale modulo di servizio.
I moduli installati possono essere trovati nel percorso specificato dalla variabile di ambiente $Env:PSModulePath o eseguendo il comando Get-Module con il parametro ListAvailable.
```
PS /> Get-Module -ListAvailable
```

Installazione da GitHub

Per installare i moduli PowerShell OCI da GitHub:

Scaricare gli artifact dei moduli OCI più recenti ed estrarli in una directory locale.
Nota

I cmdlet corrispondenti a ciascun servizio OCI supportato dai moduli OCI per PowerShell vengono inseriti in un singolo modulo Powershell denominato OCI.PSModules.<ServiceName>.

Registrare la directory estratta come repository PowerShell locale:

PS /> Register-PSRepository -Name "LocalRepo" -SourceLocation <extractedlocation>

Trovare i moduli disponibili nel repository locale:
```
PS /> Find-Module -Repository "LocalRepo"
```
Installare un modulo specifico:
```
PS /> Install-Module -Name OCI.PSModules.Objectstorage -Verbose -Repository LocalRepo
```
Nota

Ciascun modulo di servizio dipende dal modulo OCI.PSModules.Common (Common Module), che offre le funzionalità comuni a tutti i moduli di servizio. L'installazione di un modulo di servizio installerà anche la versione corrispondente di OCI.PSModules.Common per tale modulo di servizio.
I moduli installati possono essere trovati nel percorso specificato dalla variabile di ambiente $Env:PSModulePath o eseguendo il comando Get-Module con il parametro ListAvailable.
```
PS /> Get-Module -ListAvailable
```

Installazione con Yum

Se si utilizza Oracle Linux versione 7.x, i pacchetti dei moduli PowerShell OCI possono essere installati con yum.

Per installare i moduli PowerShell OCI utilizzando yum, effettuare le operazioni riportate di seguito.
```
$ sudo yum install oci-powershell-modules
```
Avviare una sessione PowerShell e registrare la directory scaricata /usr/lib/dotnet/NuPkgs come repository PowerShell locale utilizzando il comando seguente:
```
$ pwsh
PS /> Register-PSRepository -Name "LocalRepo" -SourceLocation /usr/lib/dotnet/NuPkgs
```
Trovare i moduli disponibili nel repository locale utilizzando il seguente comando:
```
PS /> Find-Module -Repository "LocalRepo"
```
Installare un modulo specifico:
```
PS /> Install-Module -Name OCI.PSModules.Objectstorage -Verbose -Repository LocalRepo
```
Nota

Ciascun modulo di servizio dipende dal modulo OCI.PSModules.Common (Common Module), che offre le funzionalità comuni a tutti i moduli di servizio. L'installazione di un modulo di servizio installerà anche la versione corrispondente di OCI.PSModules.Common per tale modulo di servizio.
I moduli installati possono essere trovati nel percorso specificato dalla variabile di ambiente $Env:PSModulePath o eseguendo il comando Get-Module con il parametro ListAvailable.
```
PS /> Get-Module -ListAvailable
```

Imposta

Se i moduli richiesti non sono stati installati, eseguire queste operazioni.

Prima di richiamare i cmdlet nei moduli OCI, è necessario impostare il file di configurazione, quindi facoltativamente importare i moduli richiesti in una sessione PowerShell.

File di configurazione

Un file di configurazione fornisce informazioni essenziali sulla configurazione, come le credenziali utente e l'OCID tenancy. Queste informazioni di configurazione vengono utilizzate dai moduli OCI per PowerShell per autenticare e interagire con i servizi Oracle Cloud. È possibile creare questo file utilizzando un cmdlet di impostazione oppure manualmente mediante un editor di testo.

Set-OCIClientConfig

Il cmdlet Set-OCIClientConfig incluso nel modulo Common assiste l'utente nell'impostazione di un file di configurazione. Questo cmdlet richiede le informazioni richieste dal file di configurazione, inclusa la coppia di chiavi utilizzata per firmare le richieste API.

Per ulteriori informazioni su come trovare le informazioni richieste, vedere:

Impostazione manuale

Se si desidera impostare manualmente la coppia di chiavi di firma API e scrivere un file di configurazione personalizzato, vedere Configurazione di SDK e strumento e Chiavi richieste.

Nota

Utilizzare il cmdlet New-OCIClientKeys per generare una coppia di chiavi di firma API da includere nel file di configurazione.

Importazione dei moduli

PowerShell importerà automaticamente il modulo (e le relative dipendenze) nella sessione la prima volta che si esegue un comando dal modulo installato. Per importare un modulo in modo esplicito, eseguire il comando Import-Module.

Ad esempio, per importare la versione 1.0.0 del modulo del servizio Identity:

PS /> Import-Module OCI.PSModules.Identity  -RequiredVersion 1.0.0   -Verbose

Per trovare tutti i moduli importati nella sessione PowerShell corrente, eseguire il comando Get-Module:

PS /> Get-Module
 
ModuleType Name                            ExportedCommands
---------- ----                            ----------------
    Binary OCI.PSModules.Common            {Clear-OCICmdletHistory, Get-OCIClientSession], Get-OCICmdletHisto…
    Binary OCI.PSModules.Identity          {Add-OCIIdentityUserToGroup, Enable-OCIIdentityMfaTotpDevice…

Nota

Ciascun modulo di servizio dipende dal modulo OCI.PSModules.Common (Common Module), che offre le funzionalità comuni a tutti i moduli di servizio. L'installazione di un modulo di servizio installerà anche la versione corrispondente di OCI.PSModules.Common per tale modulo di servizio.

Aggiornamento dei moduli

Le nuove versioni dei moduli PowerShell OCI vengono rilasciate ogni settimana. Per aggiornare i moduli PowerShell OCI installati alla versione più recente, eseguire il comando Update-Module.

Nota

Prima di aggiornare qualsiasi modulo OCI, è necessario disinstallare il modulo. Per evitare conflitti di dipendenza durante l'importazione dei moduli nella sessione PowerShell, aggiornare tutti i moduli OCI installati alla stessa versione.

PS /> Update-Module -Name "OCI.PSModules.*" -Verbose

Disinstallazione dei moduli

Per rimuovere qualsiasi modulo installato, è possibile utilizzare il cmdlet Uninstall-Module o eliminare la cartella del modulo situata nel percorso della variabile di ambiente $Env:PSModulePath.

Ad esempio:

PS /> Uninstall-Module -Name OCI.PSModules.Identity

Passi successivi

Dopo aver eseguito l'installazione e l'impostazione, è possibile passare direttamente a Utilizzo dei Cmdlet oppure a Concetti avanzati.

Documentazione dell'infrastruttura Oracle Cloud