# Installing the Module

Verify that your system has a [supported edition and version](./../index.md#powershell) of PowerShell installed.

=== ":material-pipe:   Connected Environment"

    For environments connected to the Internet, you can install the [module dependencies](./../index.md#module-dependencies) from the PowerShell Gallery by running the following commands in the PowerShell console:

    ```powershell
    --8<-- "./docs/snippets/install-module.ps1"
    ```

    In PowerShell Core, import the modules before proceeding:

    For example:

    ```powershell
    --8<-- "./docs/snippets/import-module.ps1"
    ```

=== ":material-pipe-disconnected: &nbsp; Disconnected Environment"

    For environments disconnected from the Internet _(e.g., dark-site, air-gapped)_, you can save the [module dependencies](./../index.md#module-dependencies) from the PowerShell Gallery by running the following commands in the PowerShell console:

    === ":fontawesome-brands-windows: &nbsp; Windows"

        From a system with an Internet connection, save the module dependencies from the PowerShell Gallery by running the following commands in the PowerShell console:

        ```powershell
        --8<-- "./docs/snippets/save-module-local-windows.ps1"
        ```

        From the system with the Internet connection, copy the module dependencies to a target system by running the following commands in the PowerShell console:

        ```powershell
        --8<-- "./docs/snippets/copy-module-local-windows.ps1"
        ```

        On the target system, import the module dependencies by running the following commands in the PowerShell console:

        ```powershell
        --8<-- "./docs/snippets/import-module.ps1"
        ```

    === ":fontawesome-brands-linux: &nbsp; Linux"

        Prerequisite for module install on Linux Machine

        ```powershell
        --8<-- "./docs/snippets/pre-req-linux.ps1"
        ```

        From a system with an Internet connection, save the module dependencies from the PowerShell Gallery by running the following commands in the PowerShell console:

        ```powershell
        --8<-- "./docs/snippets/save-module-local-linux.ps1"
        ```

        From the system with an Internet connection, copy the `OfflineModules.tar.gz` archive to a target system's directory:

        ```bash
        --8<-- "./docs/snippets/copy-module-local-linux.sh"
        ```

        On the target system, extract the archive uploaded in the previous step by running the following commands:

        ```bash
        --8<-- "./docs/snippets/extract-module-local-linux.sh"
        ```
        On the target system, import the module dependencies by running the following commands in the PowerShell console:

        ```powershell
        --8<-- "./docs/snippets/import-module-local-linux.ps1"
        ```

Once installed, any cmdlets associated with `VMware.CloudFoundation.PowerManagement` and the its dependencies will be available for use.

To view the cmdlets for available in the module, run the following command in the PowerShell console.

```powershell
Get-Command -Module VMware.CloudFoundation.PowerManagement
```

To view the help for any cmdlet, run the `Get-Help` command in the PowerShell console.

For example:

```powershell
Get-Help -Name <cmdlet-name>
```

```powershell
Get-Help -Name <cmdlet-name> -Examples
```