Skip to content
This repository was archived by the owner on Nov 26, 2025. It is now read-only.

Commit d77620a

Browse files
docs: add air-gapped install (#137)
Adding documentation to install modules and dependencies in a air-gapped environment. Signed-off-by: Jared Burns <[email protected]>
1 parent d0bb763 commit d77620a

File tree

7 files changed

+70
-0
lines changed

7 files changed

+70
-0
lines changed

docs/install.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Installing the Module
22

3+
## From Powershell Gallery
4+
35
Verify that your system has a [supported edition and version](/powershell-module-for-vmware-cloud-foundation-password-management/#powershell) of PowerShell installed.
46

57
Install the PowerShell [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the PowerShell Gallery by running the following commands:
@@ -24,6 +26,56 @@ To verify the module dependencies are installed, run the following commands in t
2426
Test-VcfPasswordManagementPrereq
2527
```
2628

29+
## From Air-gapped Machine
30+
31+
Verify that your system has a [supported edition and version](/powershell-module-for-vmware-cloud-foundation-password-management/#powershell) of PowerShell installed.
32+
33+
=== ":fontawesome-brands-windows: &nbsp; Windows"
34+
35+
Save Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the PowerShell Gallery on a non air-gapped machine by running the following commands:
36+
37+
```powershell
38+
--8<-- "./docs/snippets/save-module-local-windows.ps1"
39+
```
40+
41+
Copy the PowerShell Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the Local Machine to air-gapped facing machine by running the following commands:
42+
43+
```powershell
44+
--8<-- "./docs/snippets/copy-module-local-windows.ps1"
45+
```
46+
47+
Import the PowerShell Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the air-gapped machine by running the following commands:
48+
49+
```powershell
50+
--8<-- "./docs/snippets/import-module.ps1"
51+
```
52+
53+
=== ":fontawesome-brands-linux: &nbsp; Linux"
54+
55+
Prerequisite for module install on Linux Machine
56+
57+
```bash
58+
--8<-- "./docs/snippets/pre-req-linux.sh"
59+
```
60+
61+
Save Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the PowerShell Gallery on a non air-gapped machine by running the following commands:
62+
63+
```powershell
64+
--8<-- "./docs/snippets/save-module-local-linux.ps1"
65+
```
66+
67+
Copy the PowerShell Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the Local Machine to air-gapped facing machine by running the following commands:
68+
69+
```bash
70+
--8<-- "./docs/snippets/copy-module-local-linux.sh"
71+
```
72+
73+
Import the PowerShell Modules [module dependencies](/powershell-module-for-vmware-cloud-foundation-password-management/#module-dependencies) from the air-gapped machine by running the following commands in PowerShell:
74+
75+
```powershell
76+
--8<-- "./docs/snippets/import-module-local-linux.ps1"
77+
```
78+
2779
:material-information-slab-circle: &nbsp; [Reference](/powershell-module-for-vmware-cloud-foundation-password-management/documentation/functions/Test-VcfPasswordManagementPrereq/)
2880

2981
Once installed, any cmdlets associated with `VMware.CloudFoundation.PasswordManagement` and the its dependencies will be available for use.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
scp -r /home/modules/* username@remote_host:/home/lab/.local/share/powershell/Modules/
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Copy-Item -Path F:\Module\* -Destination '\\<destination_host>\C$\Program Files\WindowsPowerShell\Modules\' -Recurse
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Import-Module -Name VMware.PowerCLI
2+
Import-Module -Name VMware.vSphere.SsoAdmin
3+
Import-Module -Name PowerVCF
4+
Import-Module -Name PowerValidatedSolutions
5+
Import-Module -Name VMware.CloudFoundation.PasswordManagement

docs/snippets/pre-req-linux.sh

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
mkdir /home/modules
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Save-Module -Name VMware.vSphere.SsoAdmin -MinimumVersion 1.3.9 -Path /home/modules
2+
Save-Module -Name VMware.PowerCLI -MinimumVersion 13.0.0 -Path /home/modules
3+
Save-Module -Name PowerVCF -MinimumVersion 2.4.0 -Path /home/modules
4+
Save-Module -Name PowerValidatedSolutions -MinimumVersion 2.6.0 -Path /home/modules
5+
Save-Module -Name VMware.CloudFoundation.PasswordManagement -Path /home/modules
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Save-Module -Name VMware.vSphere.SsoAdmin -MinimumVersion 1.3.9 -Path F:\Module\
2+
Save-Module -Name VMware.PowerCLI -MinimumVersion 13.0.0 -Path F:\Module\
3+
Save-Module -Name PowerVCF -MinimumVersion 2.4.0 -Path F:\Module\
4+
Save-Module -Name PowerValidatedSolutions -MinimumVersion 2.6.0 -Path F:\Module\
5+
Save-Module -Name VMware.CloudFoundation.PasswordManagement -Path F:\Module\

0 commit comments

Comments
 (0)