Introducción

En este tema se describe cómo instalar y configurar los módulos OCI para PowerShell.

En este tema se describe cómo instalar y configurar los módulos OCI para PowerShell.

Requisitos

Asegúrese de cumplir con todos los requisitos enumerados aquí.

Instalación de módulos

  1. Iniciar una sesión en PowerShell:
    1. En Windows, inicie PowerShell desde el menú Inicio.
    2. En Linux o MacOS, ejecute pwsh desde una petición de datos de 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>
      
  2. Para instalar todos los módulos de OCI, instale el módulo básico:

    Install-Module OCI.PSModules

    Nota

    La desinstalación del módulo OCI.PSModules no desinstalará otros módulos OCI. Para desinstalar un módulo OCI específico instalado por este módulo, es necesario desinstalar primero el módulo OCI.PSModules.
  3. Puede instalar solo los módulos para un servicio individual. Los cmdlets correspondientes a cada servicio de OCI soportado por los módulos OCI para PowerShell se empaquetan en un módulo individual de Powershell denominado OCI.PSModules.<ServiceName>.
  4. Continúe con Instalación desde la galería de PowerShell o Instalación desde GitHub.

Instalación desde GitHub

Para instalar los módulos de PowerShell de OCI desde GitHub:

  1. Descargue los artefactos de los módulos OCI más recientes y extráigalos a un directorio local.
    Nota

    Los cmdlets correspondientes a cada servicio de OCI soportado por los módulos OCI para PowerShell se empaquetan en un módulo individual de Powershell denominado OCI.PSModules.<ServiceName>.
  2. Registre el directorio extraído como el repositorio local de PowerShell:
    PS /> Register-PSRepository -Name "LocalRepo" -SourceLocation <extractedlocation>
  3. Encuentre los módulos disponibles en el repositorio local:
    PS /> Find-Module -Repository "LocalRepo"
  4. Instale un módulo específico:
    PS /> Install-Module -Name OCI.PSModules.Objectstorage -Verbose -Repository LocalRepo
    Nota

    Cada módulo de servicio depende de OCI.PSModules.Common (módulo común), que ofrece funcionalidades comunes a todos los módulos de servicio. La instalación de un módulo de servicio también instalará la versión correspondiente de OCI.PSModules.Common para ese módulo de servicio.
  5. Los módulos instalados se pueden encontrar en la ruta especificada por la variable de entorno $Env:PSModulePath o ejecutando el comando Get-Module con el parámetro ListAvailable.
    PS /> Get-Module -ListAvailable

Instalación con Yum

Si utiliza Oracle Linux versión 7.x, los paquetes de los módulos de PowerShell de OCI se pueden instalar con yum.

  1. Para instalar los módulos de PowerShell de OCI mediante yum:
    $ sudo yum install oci-powershell-modules
  2. Inicie una sesión de PowerShell y registre el directorio descargado /usr/lib/dotnet/NuPkgs como un repositorio de PowerShell local mediante el siguiente comando:
    $ pwsh
    PS /> Register-PSRepository -Name "LocalRepo" -SourceLocation /usr/lib/dotnet/NuPkgs
  3. Busque los módulos disponibles en el repositorio local utilizando el siguiente comando:
    PS /> Find-Module -Repository "LocalRepo"
  4. Instale un módulo específico:
    PS /> Install-Module -Name OCI.PSModules.Objectstorage -Verbose -Repository LocalRepo
    Nota

    Cada módulo de servicio depende de OCI.PSModules.Common (módulo común), que ofrece funcionalidades comunes a todos los módulos de servicio. La instalación de un módulo de servicio también instalará la versión correspondiente de OCI.PSModules.Common para ese módulo de servicio.
  5. Los módulos instalados se pueden encontrar en la ruta especificada por la variable de entorno $Env:PSModulePath o ejecutando el comando Get-Module con el parámetro ListAvailable.
    PS /> Get-Module -ListAvailable

Configuración

Siga estos pasos de instalación si no ha instalado los módulos necesarios.

Antes de llamar a cmdlets en módulos OCI, debe configurar el archivo de configuración y, a continuación, importar los módulos necesarios a una sesión de PowerShell.

Archivo de configuración

Un archivo de configuración proporciona información de configuración esencial, como credenciales de usuario y OCID de arrendamiento. Esta información de configuración la utilizan los módulos OCI para PowerShell para autenticar e interactuar con los servicios de Oracle Cloud. Puede crear este archivo mediante un cmdlet de configuración, o manualmente con un editor de texto.

Configuración manual

Si desea configurar el par de claves de firma de API manualmente y escribir su propio archivo de configuración, consulte Configuración de herramientas y SDK y Claves necesarias.

Nota

Utilice el cmdlet New-OCIClientKeys para generar un par de claves de firma de API para incluirlo en el archivo de configuración.

Importación de módulos

PowerShell importará automáticamente el módulo (y sus dependencias) a la sesión la primera vez que ejecute algún comando desde el módulo instalado. Para importar un módulo explícitamente, ejecute el comando Import-Module.

Por ejemplo, para importar la versión 1.0.0 del módulo de servicio de identidad:

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

Para buscar todos los módulos importados en la sesión de PowerShell actual, ejecute el 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

Cada módulo de servicio depende de OCI.PSModules.Common (módulo común), que ofrece funcionalidades comunes a todos los módulos de servicio. La instalación de un módulo de servicio también instalará la versión correspondiente de OCI.PSModules.Common para ese módulo de servicio.

Actualización de módulos

Nuevas versiones semanales de los módulos de PowerShell de OCI. Para actualizar los módulos de PowerShell de OCI instalados a la última versión, ejecute el comando Update-Module.

Nota

Antes de actualizar cualquier módulo OCI, debe desinstalar el módulo. Para evitar conflictos de dependencia al importar módulos a la sesión de PowerShell, actualice todos los módulos OCI instalados a la misma versión.

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

Desinstalación de módulos

Para eliminar cualquier módulo instalado, puede utilizar el cmdlet Uninstall-Module o suprimir la carpeta de módulo ubicada en la ruta de acceso de la variable de entorno $Env:PSModulePath.

Por ejemplo:

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