From 94424367bf7e1da995de70a5f89a78c6af22fe1b Mon Sep 17 00:00:00 2001 From: Clint Branham Date: Mon, 23 Mar 2026 09:54:28 -0500 Subject: [PATCH] fix: remediate scan-4 findings F058, F062, F063, F071, F072, F073, F074, F075 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit F058 (critical): Replace while(true) infinite-loop task polling with TaskService.WaitForTask in 5 container snapshot and storage cmdlets. F073+F047 (high): Migrate net9.0 → net10.0 across both source .csproj files, build.yml, publish.yml, and test helper. F071 (medium): Add Uri.EscapeDataString() to all inline URL path segments in ~16 cmdlets that bypass service classes (D003). F062+F063 (medium): Add ConfirmImpact.High to Restart-PveContainer and Suspend-PveContainer (D006). F075 (medium): Generate markdown help docs for 89 cmdlets that were missing documentation (170 total, up from 81). F072 (low): Remove unused System.Text.Json dependency from Core.csproj. F074 (low): Raise publish smoke-test threshold from 60 to 150. F065 (low): Add .github/ISSUE_TEMPLATE/config.yml. F066 (low): Add CODEOWNERS. Also fix _TestHelper.ps1 net9.0 → net10.0 framework reference. Co-Authored-By: Claude Opus 4.6 (1M context) --- .github/ISSUE_TEMPLATE/config.yml | 5 + .github/workflows/build.yml | 16 +- .github/workflows/publish.yml | 6 +- CODEOWNERS | 1 + docs/cmdlets/Get-PveBackupInfo.md | 74 ++++ docs/cmdlets/Get-PveBackupJob.md | 97 +++++ docs/cmdlets/Get-PveClusterResource.md | 113 ++++++ docs/cmdlets/Get-PveContainerInterface.md | 105 ++++++ docs/cmdlets/Get-PveDomain.md | 97 +++++ docs/cmdlets/Get-PveFirewallAlias.md | 136 +++++++ docs/cmdlets/Get-PveFirewallGroup.md | 98 +++++ docs/cmdlets/Get-PveFirewallIpSet.md | 136 +++++++ docs/cmdlets/Get-PveFirewallIpSetEntry.md | 136 +++++++ docs/cmdlets/Get-PveFirewallOptions.md | 121 ++++++ docs/cmdlets/Get-PveFirewallRef.md | 136 +++++++ docs/cmdlets/Get-PveFirewallRule.md | 136 +++++++ docs/cmdlets/Get-PveGroup.md | 97 +++++ docs/cmdlets/Get-PveNodeConfig.md | 90 +++++ docs/cmdlets/Get-PveNodeDns.md | 90 +++++ docs/cmdlets/Get-PvePool.md | 97 +++++ docs/cmdlets/Get-PveSdnController.md | 90 +++++ docs/cmdlets/Get-PveSdnDns.md | 90 +++++ docs/cmdlets/Get-PveSdnIpam.md | 90 +++++ docs/cmdlets/Get-PveStorageStatus.md | 105 ++++++ docs/cmdlets/Get-PveTaskList.md | 158 ++++++++ docs/cmdlets/Get-PveVmGuestFsInfo.md | 105 ++++++ docs/cmdlets/Get-PveVmGuestOsInfo.md | 105 ++++++ docs/cmdlets/Import-PveOva.md | 241 ++++++++++++ docs/cmdlets/Import-PveVmDisk.md | 213 +++++++++++ docs/cmdlets/Invoke-PveSdnApply.md | 105 ++++++ docs/cmdlets/Invoke-PveVmGuestFsTrim.md | 135 +++++++ docs/cmdlets/Move-PveContainerVolume.md | 196 ++++++++++ docs/cmdlets/Move-PveVmDisk.md | 213 +++++++++++ docs/cmdlets/New-PveBackup.md | 214 +++++++++++ docs/cmdlets/New-PveBackupJob.md | 290 ++++++++++++++ docs/cmdlets/New-PveContainerTemplate.md | 136 +++++++ docs/cmdlets/New-PveDomain.md | 166 ++++++++ docs/cmdlets/New-PveFirewallAlias.md | 197 ++++++++++ docs/cmdlets/New-PveFirewallGroup.md | 135 +++++++ docs/cmdlets/New-PveFirewallIpSet.md | 181 +++++++++ docs/cmdlets/New-PveFirewallIpSetEntry.md | 212 +++++++++++ docs/cmdlets/New-PveFirewallRule.md | 337 +++++++++++++++++ docs/cmdlets/New-PveGroup.md | 134 +++++++ docs/cmdlets/New-PvePool.md | 134 +++++++ docs/cmdlets/New-PveSdnController.md | 182 +++++++++ docs/cmdlets/New-PveSdnDns.md | 197 ++++++++++ docs/cmdlets/New-PveSdnIpam.md | 181 +++++++++ docs/cmdlets/New-PveStorageDisk.md | 182 +++++++++ docs/cmdlets/Read-PveVmGuestFile.md | 119 ++++++ docs/cmdlets/Remove-PveBackupJob.md | 119 ++++++ docs/cmdlets/Remove-PveDomain.md | 119 ++++++ docs/cmdlets/Remove-PveFirewallAlias.md | 166 ++++++++ docs/cmdlets/Remove-PveFirewallGroup.md | 119 ++++++ docs/cmdlets/Remove-PveFirewallIpSet.md | 166 ++++++++ docs/cmdlets/Remove-PveFirewallIpSetEntry.md | 182 +++++++++ docs/cmdlets/Remove-PveFirewallRule.md | 166 ++++++++ docs/cmdlets/Remove-PveGroup.md | 119 ++++++ docs/cmdlets/Remove-PvePool.md | 119 ++++++ docs/cmdlets/Remove-PveSdnController.md | 119 ++++++ docs/cmdlets/Remove-PveSdnDns.md | 119 ++++++ docs/cmdlets/Remove-PveSdnIpam.md | 119 ++++++ docs/cmdlets/Remove-PveStorageContent.md | 149 ++++++++ docs/cmdlets/Remove-PveVmDisk.md | 165 ++++++++ docs/cmdlets/Resize-PveContainerDisk.md | 165 ++++++++ docs/cmdlets/Resume-PveContainer.md | 165 ++++++++ docs/cmdlets/Send-PveFile.md | 214 +++++++++++ docs/cmdlets/Set-PveApiToken.md | 180 +++++++++ docs/cmdlets/Set-PveBackupJob.md | 307 +++++++++++++++ docs/cmdlets/Set-PveDomain.md | 149 ++++++++ docs/cmdlets/Set-PveFirewallAlias.md | 197 ++++++++++ docs/cmdlets/Set-PveFirewallIpSetEntry.md | 212 +++++++++++ docs/cmdlets/Set-PveFirewallOptions.md | 292 +++++++++++++++ docs/cmdlets/Set-PveFirewallRule.md | 353 ++++++++++++++++++ docs/cmdlets/Set-PveGroup.md | 134 +++++++ docs/cmdlets/Set-PveNodeConfig.md | 149 ++++++++ docs/cmdlets/Set-PveNodeDns.md | 179 +++++++++ docs/cmdlets/Set-PvePassword.md | 134 +++++++ docs/cmdlets/Set-PvePool.md | 164 ++++++++ docs/cmdlets/Set-PveRole.md | 134 +++++++ docs/cmdlets/Set-PveSdnController.md | 164 ++++++++ docs/cmdlets/Set-PveSdnDns.md | 179 +++++++++ docs/cmdlets/Set-PveSdnIpam.md | 164 ++++++++ docs/cmdlets/Set-PveSdnSubnet.md | 195 ++++++++++ docs/cmdlets/Set-PveSdnVnet.md | 179 +++++++++ docs/cmdlets/Set-PveSdnZone.md | 164 ++++++++ docs/cmdlets/Set-PveStorage.md | 195 ++++++++++ docs/cmdlets/Set-PveStorageContent.md | 164 ++++++++ docs/cmdlets/Set-PveVmGuestPassword.md | 180 +++++++++ docs/cmdlets/Start-PveNodeVms.md | 134 +++++++ docs/cmdlets/Stop-PveNodeVms.md | 149 ++++++++ docs/cmdlets/Stop-PveTask.md | 134 +++++++ docs/cmdlets/Suspend-PveContainer.md | 165 ++++++++ docs/cmdlets/Write-PveVmGuestFile.md | 164 ++++++++ src/PSProxmoxVE.Core/PSProxmoxVE.Core.csproj | 6 +- .../CloudInit/GetPveCloudInitConfigCmdlet.cs | 3 +- .../NewPveContainerSnapshotCmdlet.cs | 21 +- .../RemovePveContainerSnapshotCmdlet.cs | 21 +- .../Containers/RestartPveContainerCmdlet.cs | 2 +- .../RestorePveContainerSnapshotCmdlet.cs | 21 +- .../Containers/SuspendPveContainerCmdlet.cs | 2 +- .../Cmdlets/Network/GetPveNetworkCmdlet.cs | 2 +- .../Network/InvokePveNetworkApplyCmdlet.cs | 3 +- .../Cmdlets/Network/NewPveNetworkCmdlet.cs | 3 +- .../Cmdlets/Network/RemovePveNetworkCmdlet.cs | 3 +- .../Cmdlets/Network/SetPveNetworkCmdlet.cs | 3 +- src/PSProxmoxVE/Cmdlets/PveCmdletBase.cs | 4 +- .../Cmdlets/Snapshots/NewPveSnapshotCmdlet.cs | 3 +- .../Snapshots/RemovePveSnapshotCmdlet.cs | 3 +- .../Snapshots/RestorePveSnapshotCmdlet.cs | 3 +- .../Storage/InvokePveStorageDownloadCmdlet.cs | 33 +- .../Cmdlets/Storage/SendPveFileCmdlet.cs | 33 +- .../Cmdlets/Tasks/WaitPveTaskCmdlet.cs | 2 +- src/PSProxmoxVE/PSProxmoxVE.csproj | 6 +- tests/PSProxmoxVE.Tests/_TestHelper.ps1 | 4 +- 114 files changed, 14072 insertions(+), 143 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 CODEOWNERS create mode 100644 docs/cmdlets/Get-PveBackupInfo.md create mode 100644 docs/cmdlets/Get-PveBackupJob.md create mode 100644 docs/cmdlets/Get-PveClusterResource.md create mode 100644 docs/cmdlets/Get-PveContainerInterface.md create mode 100644 docs/cmdlets/Get-PveDomain.md create mode 100644 docs/cmdlets/Get-PveFirewallAlias.md create mode 100644 docs/cmdlets/Get-PveFirewallGroup.md create mode 100644 docs/cmdlets/Get-PveFirewallIpSet.md create mode 100644 docs/cmdlets/Get-PveFirewallIpSetEntry.md create mode 100644 docs/cmdlets/Get-PveFirewallOptions.md create mode 100644 docs/cmdlets/Get-PveFirewallRef.md create mode 100644 docs/cmdlets/Get-PveFirewallRule.md create mode 100644 docs/cmdlets/Get-PveGroup.md create mode 100644 docs/cmdlets/Get-PveNodeConfig.md create mode 100644 docs/cmdlets/Get-PveNodeDns.md create mode 100644 docs/cmdlets/Get-PvePool.md create mode 100644 docs/cmdlets/Get-PveSdnController.md create mode 100644 docs/cmdlets/Get-PveSdnDns.md create mode 100644 docs/cmdlets/Get-PveSdnIpam.md create mode 100644 docs/cmdlets/Get-PveStorageStatus.md create mode 100644 docs/cmdlets/Get-PveTaskList.md create mode 100644 docs/cmdlets/Get-PveVmGuestFsInfo.md create mode 100644 docs/cmdlets/Get-PveVmGuestOsInfo.md create mode 100644 docs/cmdlets/Import-PveOva.md create mode 100644 docs/cmdlets/Import-PveVmDisk.md create mode 100644 docs/cmdlets/Invoke-PveSdnApply.md create mode 100644 docs/cmdlets/Invoke-PveVmGuestFsTrim.md create mode 100644 docs/cmdlets/Move-PveContainerVolume.md create mode 100644 docs/cmdlets/Move-PveVmDisk.md create mode 100644 docs/cmdlets/New-PveBackup.md create mode 100644 docs/cmdlets/New-PveBackupJob.md create mode 100644 docs/cmdlets/New-PveContainerTemplate.md create mode 100644 docs/cmdlets/New-PveDomain.md create mode 100644 docs/cmdlets/New-PveFirewallAlias.md create mode 100644 docs/cmdlets/New-PveFirewallGroup.md create mode 100644 docs/cmdlets/New-PveFirewallIpSet.md create mode 100644 docs/cmdlets/New-PveFirewallIpSetEntry.md create mode 100644 docs/cmdlets/New-PveFirewallRule.md create mode 100644 docs/cmdlets/New-PveGroup.md create mode 100644 docs/cmdlets/New-PvePool.md create mode 100644 docs/cmdlets/New-PveSdnController.md create mode 100644 docs/cmdlets/New-PveSdnDns.md create mode 100644 docs/cmdlets/New-PveSdnIpam.md create mode 100644 docs/cmdlets/New-PveStorageDisk.md create mode 100644 docs/cmdlets/Read-PveVmGuestFile.md create mode 100644 docs/cmdlets/Remove-PveBackupJob.md create mode 100644 docs/cmdlets/Remove-PveDomain.md create mode 100644 docs/cmdlets/Remove-PveFirewallAlias.md create mode 100644 docs/cmdlets/Remove-PveFirewallGroup.md create mode 100644 docs/cmdlets/Remove-PveFirewallIpSet.md create mode 100644 docs/cmdlets/Remove-PveFirewallIpSetEntry.md create mode 100644 docs/cmdlets/Remove-PveFirewallRule.md create mode 100644 docs/cmdlets/Remove-PveGroup.md create mode 100644 docs/cmdlets/Remove-PvePool.md create mode 100644 docs/cmdlets/Remove-PveSdnController.md create mode 100644 docs/cmdlets/Remove-PveSdnDns.md create mode 100644 docs/cmdlets/Remove-PveSdnIpam.md create mode 100644 docs/cmdlets/Remove-PveStorageContent.md create mode 100644 docs/cmdlets/Remove-PveVmDisk.md create mode 100644 docs/cmdlets/Resize-PveContainerDisk.md create mode 100644 docs/cmdlets/Resume-PveContainer.md create mode 100644 docs/cmdlets/Send-PveFile.md create mode 100644 docs/cmdlets/Set-PveApiToken.md create mode 100644 docs/cmdlets/Set-PveBackupJob.md create mode 100644 docs/cmdlets/Set-PveDomain.md create mode 100644 docs/cmdlets/Set-PveFirewallAlias.md create mode 100644 docs/cmdlets/Set-PveFirewallIpSetEntry.md create mode 100644 docs/cmdlets/Set-PveFirewallOptions.md create mode 100644 docs/cmdlets/Set-PveFirewallRule.md create mode 100644 docs/cmdlets/Set-PveGroup.md create mode 100644 docs/cmdlets/Set-PveNodeConfig.md create mode 100644 docs/cmdlets/Set-PveNodeDns.md create mode 100644 docs/cmdlets/Set-PvePassword.md create mode 100644 docs/cmdlets/Set-PvePool.md create mode 100644 docs/cmdlets/Set-PveRole.md create mode 100644 docs/cmdlets/Set-PveSdnController.md create mode 100644 docs/cmdlets/Set-PveSdnDns.md create mode 100644 docs/cmdlets/Set-PveSdnIpam.md create mode 100644 docs/cmdlets/Set-PveSdnSubnet.md create mode 100644 docs/cmdlets/Set-PveSdnVnet.md create mode 100644 docs/cmdlets/Set-PveSdnZone.md create mode 100644 docs/cmdlets/Set-PveStorage.md create mode 100644 docs/cmdlets/Set-PveStorageContent.md create mode 100644 docs/cmdlets/Set-PveVmGuestPassword.md create mode 100644 docs/cmdlets/Start-PveNodeVms.md create mode 100644 docs/cmdlets/Stop-PveNodeVms.md create mode 100644 docs/cmdlets/Stop-PveTask.md create mode 100644 docs/cmdlets/Suspend-PveContainer.md create mode 100644 docs/cmdlets/Write-PveVmGuestFile.md diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..be0261a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Questions & Discussions + url: https://github.com/goodolclint/PSProxmoxVE/discussions + about: Ask questions and discuss features in GitHub Discussions diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 088b1ac..a3f3f34 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -15,7 +15,7 @@ jobs: - name: Setup .NET uses: actions/setup-dotnet@v5 with: - dotnet-version: '9.0.x' + dotnet-version: '10.0.x' - name: Restore dependencies run: | dotnet restore src/PSProxmoxVE/PSProxmoxVE.csproj @@ -33,7 +33,7 @@ jobs: name: coverage-net48 path: ./coverage - build-net9: + build-net10: strategy: matrix: os: [windows-latest, ubuntu-latest] @@ -44,16 +44,16 @@ jobs: - name: Setup .NET uses: actions/setup-dotnet@v5 with: - dotnet-version: '9.0.x' + dotnet-version: '10.0.x' - name: Restore dependencies run: dotnet restore - - name: Build net9.0 - run: dotnet build --configuration Release --framework net9.0 --no-restore - - name: Test net9.0 - run: dotnet test tests/PSProxmoxVE.Core.Tests/PSProxmoxVE.Core.Tests.csproj --configuration Release --framework net9.0 --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./coverage + - name: Build net10.0 + run: dotnet build --configuration Release --framework net10.0 --no-restore + - name: Test net10.0 + run: dotnet test tests/PSProxmoxVE.Core.Tests/PSProxmoxVE.Core.Tests.csproj --configuration Release --framework net10.0 --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./coverage - name: Upload coverage if: always() uses: actions/upload-artifact@v7 with: - name: coverage-net9-${{ matrix.os }} + name: coverage-net10-${{ matrix.os }} path: ./coverage diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index b64f532..b3e3fc6 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -19,7 +19,7 @@ jobs: - name: Setup .NET uses: actions/setup-dotnet@v5 with: - dotnet-version: '9.0.x' + dotnet-version: '10.0.x' - name: Extract version from tag id: version @@ -55,8 +55,8 @@ jobs: Import-Module PSProxmoxVE -Force -ErrorAction Stop $commands = Get-Command -Module PSProxmoxVE Write-Host "Module loaded with $($commands.Count) commands" - if ($commands.Count -lt 60) { - throw "Expected at least 60 commands, got $($commands.Count)" + if ($commands.Count -lt 150) { + throw "Expected at least 150 commands, got $($commands.Count)" } - name: Publish to PSGallery diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..32cb68f --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1 @@ +* @goodolclint diff --git a/docs/cmdlets/Get-PveBackupInfo.md b/docs/cmdlets/Get-PveBackupInfo.md new file mode 100644 index 0000000..dacb4ad --- /dev/null +++ b/docs/cmdlets/Get-PveBackupInfo.md @@ -0,0 +1,74 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveBackupInfo + +## SYNOPSIS +Lists guests not covered by any backup job. + +## SYNTAX + +``` +Get-PveBackupInfo [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns information about VMs and containers that are not included in any scheduled backup job. Useful for backup compliance auditing. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveBackupInfo +``` + +Returns all guests not covered by any backup job. + +## PARAMETERS + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Management.Automation.PSObject +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveBackupJob.md b/docs/cmdlets/Get-PveBackupJob.md new file mode 100644 index 0000000..2bfcc94 --- /dev/null +++ b/docs/cmdlets/Get-PveBackupJob.md @@ -0,0 +1,97 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveBackupJob + +## SYNOPSIS +Lists Proxmox VE backup jobs. + +## SYNTAX + +``` +Get-PveBackupJob [[-Id] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns scheduled backup job configurations from the Proxmox VE cluster. Optionally filter by job ID. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveBackupJob +``` + +Returns all backup jobs. + +### Example 2 +```powershell +PS C:\> Get-PveBackupJob -Id "backup-abc123" +``` + +Returns the backup job with the specified ID. + +## PARAMETERS + +### -Id +The backup job ID to retrieve. When omitted, all jobs are returned. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Backup.PveBackupJob +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveClusterResource.md b/docs/cmdlets/Get-PveClusterResource.md new file mode 100644 index 0000000..6ca141d --- /dev/null +++ b/docs/cmdlets/Get-PveClusterResource.md @@ -0,0 +1,113 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveClusterResource + +## SYNOPSIS +Lists resources across the Proxmox VE cluster. + +## SYNTAX + +``` +Get-PveClusterResource [[-Type] ] [-Node ] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns cluster-wide resources (VMs, containers, nodes, storage, SDN). Optionally filter by resource type or node name. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveClusterResource +``` + +Returns all cluster resources. + +### Example 2 +```powershell +PS C:\> Get-PveClusterResource -Type vm +``` + +Returns only VM resources across the cluster. + +## PARAMETERS + +### -Type +Filter by resource type. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: vm, lxc, node, storage, sdn + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +Filter results to a specific node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Cluster.PveClusterResource +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveContainerInterface.md b/docs/cmdlets/Get-PveContainerInterface.md new file mode 100644 index 0000000..bc87c77 --- /dev/null +++ b/docs/cmdlets/Get-PveContainerInterface.md @@ -0,0 +1,105 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveContainerInterface + +## SYNOPSIS +Gets network interface information for an LXC container. + +## SYNTAX + +``` +Get-PveContainerInterface [-Node] [-VmId] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Retrieves network interface information for the specified LXC container via the Proxmox VE API, including interface names, MAC addresses, and IP addresses. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveContainerInterface -Node "pve1" -VmId 100 +``` + +Returns network interface information for container 100 on node pve1. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Containers.PveContainerInterface +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveDomain.md b/docs/cmdlets/Get-PveDomain.md new file mode 100644 index 0000000..4c67c52 --- /dev/null +++ b/docs/cmdlets/Get-PveDomain.md @@ -0,0 +1,97 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveDomain + +## SYNOPSIS +Lists Proxmox VE authentication domains/realms. + +## SYNTAX + +``` +Get-PveDomain [[-Realm] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns all authentication domains (realms) from the Proxmox VE access management system. Optionally filter by a specific realm name. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveDomain +``` + +Returns all authentication domains. + +### Example 2 +```powershell +PS C:\> Get-PveDomain -Realm "pam" +``` + +Returns only the pam authentication domain. + +## PARAMETERS + +### -Realm +Optional realm name to filter results. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Users.PveDomain +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallAlias.md b/docs/cmdlets/Get-PveFirewallAlias.md new file mode 100644 index 0000000..e5a3163 --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallAlias.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallAlias + +## SYNOPSIS +Lists firewall aliases at the specified level. + +## SYNTAX + +``` +Get-PveFirewallAlias [-Level] [-Node ] [-VmId ] [-Name ] + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns firewall alias definitions at the Cluster, Node, Vm, or Container level. Optionally filter by alias name. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallAlias -Level Cluster +``` + +Returns all cluster-level firewall aliases. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +Optional alias name to filter by. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallAlias +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallGroup.md b/docs/cmdlets/Get-PveFirewallGroup.md new file mode 100644 index 0000000..e2d546c --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallGroup.md @@ -0,0 +1,98 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallGroup + +## SYNOPSIS +Lists firewall security groups or rules within a group. + +## SYNTAX + +``` +Get-PveFirewallGroup [[-Group] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns firewall security groups. When a group name is specified, returns the rules within that group. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallGroup +``` + +Returns all firewall security groups. + +### Example 2 +```powershell +PS C:\> Get-PveFirewallGroup -Group "webservers" +``` + +Returns the rules within the webservers security group. + +## PARAMETERS + +### -Group +The security group name. If specified, returns rules within the group. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallGroup +### PSProxmoxVE.Core.Models.Firewall.PveFirewallRule +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallIpSet.md b/docs/cmdlets/Get-PveFirewallIpSet.md new file mode 100644 index 0000000..6e3cfc3 --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallIpSet.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallIpSet + +## SYNOPSIS +Lists firewall IP sets at the specified level. + +## SYNTAX + +``` +Get-PveFirewallIpSet [-Level] [-Node ] [-VmId ] [-Name ] + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns firewall IP set definitions at the Cluster, Node, Vm, or Container level. Optionally filter by IP set name. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallIpSet -Level Cluster +``` + +Returns all cluster-level IP sets. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +Optional IP set name to filter by. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallIpSet +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallIpSetEntry.md b/docs/cmdlets/Get-PveFirewallIpSetEntry.md new file mode 100644 index 0000000..168240b --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallIpSetEntry.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallIpSetEntry + +## SYNOPSIS +Lists entries in a firewall IP set. + +## SYNTAX + +``` +Get-PveFirewallIpSetEntry [-Level] [-Node ] [-VmId ] -Name + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns all entries (CIDR addresses) within the specified firewall IP set at the given level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallIpSetEntry -Level Cluster -Name "trusted" +``` + +Returns all entries in the cluster-level IP set named trusted. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallIpSetEntry +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallOptions.md b/docs/cmdlets/Get-PveFirewallOptions.md new file mode 100644 index 0000000..88fa5e9 --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallOptions.md @@ -0,0 +1,121 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallOptions + +## SYNOPSIS +Gets firewall options at the specified level. + +## SYNTAX + +``` +Get-PveFirewallOptions [-Level] [-Node ] [-VmId ] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns firewall configuration options at the Cluster, Node, Vm, or Container level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallOptions -Level Cluster +``` + +Returns the cluster-level firewall options. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallOptions +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallRef.md b/docs/cmdlets/Get-PveFirewallRef.md new file mode 100644 index 0000000..7b37bef --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallRef.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallRef + +## SYNOPSIS +Lists firewall references at the specified level. + +## SYNTAX + +``` +Get-PveFirewallRef [-Level] [-Node ] [-VmId ] [-Type ] + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns firewall references (aliases, IP sets, etc.) available at the Cluster, Node, Vm, or Container level. Optionally filter by type. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallRef -Level Cluster +``` + +Returns all cluster-level firewall references. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +Optional type filter for references. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallRef +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveFirewallRule.md b/docs/cmdlets/Get-PveFirewallRule.md new file mode 100644 index 0000000..e0c6d9b --- /dev/null +++ b/docs/cmdlets/Get-PveFirewallRule.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveFirewallRule + +## SYNOPSIS +Lists firewall rules at the specified level. + +## SYNTAX + +``` +Get-PveFirewallRule [-Level] [-Node ] [-VmId ] [-Position ] + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns firewall rules at the Cluster, Node, Vm, or Container level. Optionally filter by rule position. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveFirewallRule -Level Cluster +``` + +Returns all cluster-level firewall rules. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Position +Optional rule position to filter by. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallRule +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveGroup.md b/docs/cmdlets/Get-PveGroup.md new file mode 100644 index 0000000..b33f85f --- /dev/null +++ b/docs/cmdlets/Get-PveGroup.md @@ -0,0 +1,97 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveGroup + +## SYNOPSIS +Lists Proxmox VE groups. + +## SYNTAX + +``` +Get-PveGroup [[-GroupId] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns all groups from the Proxmox VE access management system. Optionally filter by a specific group ID. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveGroup +``` + +Returns all groups. + +### Example 2 +```powershell +PS C:\> Get-PveGroup -GroupId "admins" +``` + +Returns the specified group. + +## PARAMETERS + +### -GroupId +Optional group ID to filter results. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Users.PveGroup +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveNodeConfig.md b/docs/cmdlets/Get-PveNodeConfig.md new file mode 100644 index 0000000..f3ef745 --- /dev/null +++ b/docs/cmdlets/Get-PveNodeConfig.md @@ -0,0 +1,90 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveNodeConfig + +## SYNOPSIS +Returns the configuration of a Proxmox VE node. + +## SYNTAX + +``` +Get-PveNodeConfig [-Node] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Retrieves the node configuration from the /nodes/{node}/config endpoint, including description, wakeonlan settings and other node-level properties. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveNodeConfig -Node "pve1" +``` + +Returns the configuration for node pve1. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### System.Management.Automation.PSObject +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveNodeDns.md b/docs/cmdlets/Get-PveNodeDns.md new file mode 100644 index 0000000..6a8d46d --- /dev/null +++ b/docs/cmdlets/Get-PveNodeDns.md @@ -0,0 +1,90 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveNodeDns + +## SYNOPSIS +Returns the DNS configuration of a Proxmox VE node. + +## SYNTAX + +``` +Get-PveNodeDns [-Node] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Retrieves the DNS settings (search domain and nameservers) for the specified node from the /nodes/{node}/dns endpoint. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveNodeDns -Node "pve1" +``` + +Returns the DNS configuration for node pve1. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### System.Management.Automation.PSObject +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PvePool.md b/docs/cmdlets/Get-PvePool.md new file mode 100644 index 0000000..e5b39db --- /dev/null +++ b/docs/cmdlets/Get-PvePool.md @@ -0,0 +1,97 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PvePool + +## SYNOPSIS +Lists Proxmox VE resource pools. + +## SYNTAX + +``` +Get-PvePool [[-PoolId] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns resource pool configurations from the Proxmox VE cluster. Optionally filter by pool ID to retrieve a specific pool with its members. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PvePool +``` + +Returns all resource pools. + +### Example 2 +```powershell +PS C:\> Get-PvePool -PoolId "production" +``` + +Returns the specified pool with its members. + +## PARAMETERS + +### -PoolId +The pool ID to retrieve. When omitted, all pools are returned. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Cluster.PvePool +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveSdnController.md b/docs/cmdlets/Get-PveSdnController.md new file mode 100644 index 0000000..9bf7e96 --- /dev/null +++ b/docs/cmdlets/Get-PveSdnController.md @@ -0,0 +1,90 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveSdnController + +## SYNOPSIS +Lists SDN controllers in Proxmox VE. + +## SYNTAX + +``` +Get-PveSdnController [[-Controller] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns Software-Defined Networking controller definitions. Optionally filters by controller identifier. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveSdnController +``` + +Returns all SDN controllers. + +## PARAMETERS + +### -Controller +Filter by controller identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Network.PveSdnController +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveSdnDns.md b/docs/cmdlets/Get-PveSdnDns.md new file mode 100644 index 0000000..8284c9a --- /dev/null +++ b/docs/cmdlets/Get-PveSdnDns.md @@ -0,0 +1,90 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveSdnDns + +## SYNOPSIS +Lists SDN DNS plugins in Proxmox VE. + +## SYNTAX + +``` +Get-PveSdnDns [[-Dns] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns Software-Defined Networking DNS plugin definitions. Optionally filters by DNS identifier. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveSdnDns +``` + +Returns all SDN DNS plugins. + +## PARAMETERS + +### -Dns +Filter by DNS plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Network.PveSdnDns +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveSdnIpam.md b/docs/cmdlets/Get-PveSdnIpam.md new file mode 100644 index 0000000..b229edc --- /dev/null +++ b/docs/cmdlets/Get-PveSdnIpam.md @@ -0,0 +1,90 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveSdnIpam + +## SYNOPSIS +Lists SDN IPAM plugins in Proxmox VE. + +## SYNTAX + +``` +Get-PveSdnIpam [[-Ipam] ] [-Session ] [-ProgressAction ] + [] +``` + +## DESCRIPTION +Returns Software-Defined Networking IPAM plugin definitions. Optionally filters by IPAM identifier. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveSdnIpam +``` + +Returns all SDN IPAM plugins. + +## PARAMETERS + +### -Ipam +Filter by IPAM plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Network.PveSdnIpam +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveStorageStatus.md b/docs/cmdlets/Get-PveStorageStatus.md new file mode 100644 index 0000000..61bc044 --- /dev/null +++ b/docs/cmdlets/Get-PveStorageStatus.md @@ -0,0 +1,105 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveStorageStatus + +## SYNOPSIS +Returns the status of a Proxmox VE storage on a node. + +## SYNTAX + +``` +Get-PveStorageStatus [-Node] [-Storage] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Retrieves capacity, usage and activation status for the specified storage on the given node from the /nodes/{node}/storage/{storage}/status endpoint. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveStorageStatus -Node "pve1" -Storage "local-lvm" +``` + +Returns the status of the local-lvm storage on node pve1. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Storage.PveStorageStatus +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveTaskList.md b/docs/cmdlets/Get-PveTaskList.md new file mode 100644 index 0000000..c6364d7 --- /dev/null +++ b/docs/cmdlets/Get-PveTaskList.md @@ -0,0 +1,158 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveTaskList + +## SYNOPSIS +Lists tasks on a Proxmox VE node. + +## SYNTAX + +``` +Get-PveTaskList [-Node] [-VmId ] [-Source ] [-TypeFilter ] [-Limit ] + [-Session ] [-ProgressAction ] [] +``` + +## DESCRIPTION +Returns a list of recent tasks on the specified node. Use optional parameters to filter by VM ID, source, or task type. Unlike Get-PveTask which retrieves a single task by UPID, this cmdlet lists multiple tasks. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveTaskList -Node "pve1" +``` + +Returns the 50 most recent tasks on node pve1. + +### Example 2 +```powershell +PS C:\> Get-PveTaskList -Node "pve1" -VmId 100 -Limit 10 +``` + +Returns the 10 most recent tasks for VM 100. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +Filter tasks by VM ID. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Source +Filter by task source: all or active. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: all, active + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -TypeFilter +Filter by task type (e.g., qmstart, vzdump). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Limit +Maximum number of tasks to return. Defaults to 50. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: 50 +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveVmGuestFsInfo.md b/docs/cmdlets/Get-PveVmGuestFsInfo.md new file mode 100644 index 0000000..5239855 --- /dev/null +++ b/docs/cmdlets/Get-PveVmGuestFsInfo.md @@ -0,0 +1,105 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveVmGuestFsInfo + +## SYNOPSIS +Gets filesystem information from the QEMU guest agent. + +## SYNTAX + +``` +Get-PveVmGuestFsInfo [-Node] [-VmId] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Queries the QEMU guest agent running inside the specified VM for its filesystem information, including mount points, filesystem types, and usage statistics. The guest agent must be installed and running inside the VM. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveVmGuestFsInfo -Node "pve1" -VmId 100 +``` + +Returns filesystem information for VM 100. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveGuestFsInfo +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Get-PveVmGuestOsInfo.md b/docs/cmdlets/Get-PveVmGuestOsInfo.md new file mode 100644 index 0000000..e095449 --- /dev/null +++ b/docs/cmdlets/Get-PveVmGuestOsInfo.md @@ -0,0 +1,105 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Get-PveVmGuestOsInfo + +## SYNOPSIS +Gets OS information from the QEMU guest agent. + +## SYNTAX + +``` +Get-PveVmGuestOsInfo [-Node] [-VmId] [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Queries the QEMU guest agent running inside the specified VM for its operating system information, including OS name, kernel version, and machine type. The guest agent must be installed and running inside the VM. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-PveVmGuestOsInfo -Node "pve1" -VmId 100 +``` + +Returns OS information for VM 100. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveGuestOsInfo +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Import-PveOva.md b/docs/cmdlets/Import-PveOva.md new file mode 100644 index 0000000..c9b018a --- /dev/null +++ b/docs/cmdlets/Import-PveOva.md @@ -0,0 +1,241 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Import-PveOva + +## SYNOPSIS +Imports an OVA file into a Proxmox VE virtual machine. + +## SYNTAX + +``` +Import-PveOva [-Node] [-Storage] [-Path] -TargetStorage [-VmId ] + [-Name ] [-Memory ] [-Cores ] [-Wait] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Imports an OVA (Open Virtual Appliance) archive into Proxmox VE by parsing the embedded OVF descriptor, uploading the OVA, creating a new VM, and importing each disk. Use -Name, -Memory, or -Cores to override values from the OVF. Use -Wait to block until all import tasks complete. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Import-PveOva -Node "pve1" -Storage "local" -Path "C:\VMs\appliance.ova" -TargetStorage "local-lvm" -Wait +``` + +Imports an OVA file into a new VM on node pve1. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool for OVA upload. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Path +Local path to the OVA file. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 2 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -TargetStorage +Target storage for imported VM disks. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. Auto-assigned if omitted. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +Override the VM name from the OVF. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Memory +Override memory size in MiB. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cores +Override CPU core count. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for all tasks to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveVm +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Import-PveVmDisk.md b/docs/cmdlets/Import-PveVmDisk.md new file mode 100644 index 0000000..7ed3e94 --- /dev/null +++ b/docs/cmdlets/Import-PveVmDisk.md @@ -0,0 +1,213 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Import-PveVmDisk + +## SYNOPSIS +Imports a disk image into a Proxmox VE virtual machine. + +## SYNTAX + +``` +Import-PveVmDisk [-Disk] -Node -VmId -TargetStorage -Source + [-Format ] [-Wait] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Imports a disk image file into the specified VM by setting a disk configuration key with the PVE import-from syntax. The image can be a file already on PVE storage, a VMDK inside an uploaded OVA archive, or an absolute path on the PVE node. Use -Wait to block until complete. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Import-PveVmDisk -Node "pve1" -VmId 100 -Disk scsi0 -TargetStorage "local-lvm" -Source "local:iso/noble-server-cloudimg-amd64.img" -Wait +``` + +Imports a cloud image into VM 100. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Disk +Target disk slot (e.g. scsi0, sata0, virtio0). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -TargetStorage +Target storage for the imported disk. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Source +Import source (e.g. local:iso/image.img or local:import/vm.ova/disk.vmdk). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Format +Target disk format (qcow2, raw, vmdk). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: qcow2, raw, vmdk + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for the import task to complete. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Invoke-PveSdnApply.md b/docs/cmdlets/Invoke-PveSdnApply.md new file mode 100644 index 0000000..7951961 --- /dev/null +++ b/docs/cmdlets/Invoke-PveSdnApply.md @@ -0,0 +1,105 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Invoke-PveSdnApply + +## SYNOPSIS +Applies pending SDN configuration changes in Proxmox VE. + +## SYNTAX + +``` +Invoke-PveSdnApply [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Applies all pending Software-Defined Networking configuration changes cluster-wide. Run this after making changes with Set-PveSdnZone, Set-PveSdnVnet, etc. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Invoke-PveSdnApply +``` + +Applies all pending SDN configuration changes. + +## PARAMETERS + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Invoke-PveVmGuestFsTrim.md b/docs/cmdlets/Invoke-PveVmGuestFsTrim.md new file mode 100644 index 0000000..c9d2f40 --- /dev/null +++ b/docs/cmdlets/Invoke-PveVmGuestFsTrim.md @@ -0,0 +1,135 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Invoke-PveVmGuestFsTrim + +## SYNOPSIS +Invokes an fstrim operation inside the guest via the QEMU guest agent. + +## SYNTAX + +``` +Invoke-PveVmGuestFsTrim [-Node] [-VmId] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Triggers an fstrim (filesystem trim) operation inside the guest operating system using the QEMU guest agent. This reclaims unused space on thin-provisioned storage. The guest agent must be installed and running inside the VM. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Invoke-PveVmGuestFsTrim -Node "pve1" -VmId 100 +``` + +Triggers fstrim on VM 100. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.Int32 +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Move-PveContainerVolume.md b/docs/cmdlets/Move-PveContainerVolume.md new file mode 100644 index 0000000..c0717ef --- /dev/null +++ b/docs/cmdlets/Move-PveContainerVolume.md @@ -0,0 +1,196 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Move-PveContainerVolume + +## SYNOPSIS +Moves a container volume to a different storage. + +## SYNTAX + +``` +Move-PveContainerVolume -Node -VmId -Volume -Storage [-Delete] [-Wait] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Moves the specified volume on an LXC container to a different storage backend via the Proxmox VE API. Optionally deletes the original volume after a successful move. Use -Wait to block until the move task completes. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Move-PveContainerVolume -Node "pve1" -VmId 100 -Volume "rootfs" -Storage "local-lvm" -Wait +``` + +Moves the rootfs volume of container 100 to local-lvm storage. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Volume +The volume to move (e.g. rootfs, mp0). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The target storage identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Delete +Delete the original volume after move (default true). + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Move-PveVmDisk.md b/docs/cmdlets/Move-PveVmDisk.md new file mode 100644 index 0000000..9c40f5c --- /dev/null +++ b/docs/cmdlets/Move-PveVmDisk.md @@ -0,0 +1,213 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Move-PveVmDisk + +## SYNOPSIS +Moves a VM disk to a different storage. + +## SYNTAX + +``` +Move-PveVmDisk -Node -VmId -Disk -Storage [-Format ] [-Delete] + [-Wait] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Moves the specified disk on a QEMU/KVM virtual machine to a different storage backend via the Proxmox VE API. Optionally deletes the original disk after a successful move. Use -Wait to block until the move task completes. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Move-PveVmDisk -Node "pve1" -VmId 100 -Disk "scsi0" -Storage "local-lvm" -Wait +``` + +Moves the scsi0 disk of VM 100 to local-lvm storage. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Disk +The disk slot to move (e.g. scsi0, virtio0). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The target storage identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Format +Target disk format (raw, qcow2, vmdk). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: raw, qcow2, vmdk + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Delete +Delete the original disk after move (default true). + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveBackup.md b/docs/cmdlets/New-PveBackup.md new file mode 100644 index 0000000..85e3d61 --- /dev/null +++ b/docs/cmdlets/New-PveBackup.md @@ -0,0 +1,214 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveBackup + +## SYNOPSIS +Creates an ad-hoc backup of a virtual machine via vzdump. + +## SYNTAX + +``` +New-PveBackup [-Node] [-VmId] [-Storage ] [-Mode ] [-Compress ] + [-Wait] [-Timeout ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Triggers an immediate backup (vzdump) of the specified VM on the given node. Returns a PveTask representing the backup operation. Use -Wait to block until the backup completes. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveBackup -Node "pve1" -VmId 100 -Storage "backup-store" -Mode snapshot -Wait +``` + +Creates a snapshot backup of VM 100 and waits for completion. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Storage +The target storage for the backup. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode +The backup mode. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: snapshot, suspend, stop + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Compress +The compression algorithm. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: zstd, lzo, gzip, none + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Timeout +Timeout in seconds for -Wait (default 3600). + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: 3600 +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveBackupJob.md b/docs/cmdlets/New-PveBackupJob.md new file mode 100644 index 0000000..baea0fc --- /dev/null +++ b/docs/cmdlets/New-PveBackupJob.md @@ -0,0 +1,290 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveBackupJob + +## SYNOPSIS +Creates a scheduled backup job on Proxmox VE. + +## SYNTAX + +``` +New-PveBackupJob -Schedule -Storage [-Mode ] [-VmId ] [-All] + [-Compress ] [-Node ] [-MailTo ] [-MailNotification ] [-Enabled] + [-Comment ] [-PruneBackups ] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Creates a new scheduled backup job in the Proxmox VE cluster configuration. Specify a cron-style schedule and target storage. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveBackupJob -Schedule '0 2 * * *' -Storage backup-store +``` + +Creates a nightly backup job at 2 AM. + +## PARAMETERS + +### -Schedule +Cron-style schedule expression (e.g., '0 2 * * *'). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The target storage for backups. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode +The backup mode. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: snapshot, suspend, stop + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +Comma-separated list of VM IDs to back up. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -All +Back up all VMs. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Compress +The compression algorithm. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: zstd, lzo, gzip, none + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node to restrict the backup job to. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -MailTo +Email address(es) for notifications. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -MailNotification +When to send email notifications. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: always, failure + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enabled +Whether the backup job is enabled. Default is enabled. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +A comment or description for the backup job. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PruneBackups +Prune-backups configuration string. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveContainerTemplate.md b/docs/cmdlets/New-PveContainerTemplate.md new file mode 100644 index 0000000..29be4b6 --- /dev/null +++ b/docs/cmdlets/New-PveContainerTemplate.md @@ -0,0 +1,136 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveContainerTemplate + +## SYNOPSIS +Converts an LXC container to a template. + +## SYNTAX + +``` +New-PveContainerTemplate -Node -VmId [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Converts the specified LXC container into a template via the Proxmox VE API. This operation is irreversible -- once converted, the container cannot be started and can only be used as a base for cloning. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveContainerTemplate -Node "pve1" -VmId 100 +``` + +Converts container 100 to a template. + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveDomain.md b/docs/cmdlets/New-PveDomain.md new file mode 100644 index 0000000..cb734f0 --- /dev/null +++ b/docs/cmdlets/New-PveDomain.md @@ -0,0 +1,166 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveDomain + +## SYNOPSIS +Creates a new Proxmox VE authentication domain/realm. + +## SYNTAX + +``` +New-PveDomain [-Realm] [-Type] [-Comment ] [-Default] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Adds a new authentication domain (realm) to the Proxmox VE access management system. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveDomain -Realm myldap -Type ldap +``` + +Creates a new LDAP authentication domain. + +## PARAMETERS + +### -Realm +The realm identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The domain type (pam, pve, ad, ldap, openid). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: pam, pve, ad, ldap, openid + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Comment or description for the domain. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Default +Set as the default authentication domain. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Users.PveDomain +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveFirewallAlias.md b/docs/cmdlets/New-PveFirewallAlias.md new file mode 100644 index 0000000..7c2d6e2 --- /dev/null +++ b/docs/cmdlets/New-PveFirewallAlias.md @@ -0,0 +1,197 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveFirewallAlias + +## SYNOPSIS +Creates a new firewall alias. + +## SYNTAX + +``` +New-PveFirewallAlias [-Level] [-Node ] [-VmId ] -Name -Cidr + [-Comment ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Creates a new firewall alias at the specified level (Cluster, Node, Vm, or Container). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveFirewallAlias -Level Cluster -Name myserver -Cidr 10.0.0.1/32 +``` + +Creates a cluster-level firewall alias. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The alias name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cidr +The CIDR network address. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Optional comment for the alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveFirewallGroup.md b/docs/cmdlets/New-PveFirewallGroup.md new file mode 100644 index 0000000..0dfa6c8 --- /dev/null +++ b/docs/cmdlets/New-PveFirewallGroup.md @@ -0,0 +1,135 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveFirewallGroup + +## SYNOPSIS +Creates a new firewall security group. + +## SYNTAX + +``` +New-PveFirewallGroup [-Group] [-Comment ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Creates a new firewall security group with an optional comment. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveFirewallGroup -Group webservers +``` + +Creates a security group named webservers. + +## PARAMETERS + +### -Group +The security group name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Optional comment for the security group. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveFirewallIpSet.md b/docs/cmdlets/New-PveFirewallIpSet.md new file mode 100644 index 0000000..a941736 --- /dev/null +++ b/docs/cmdlets/New-PveFirewallIpSet.md @@ -0,0 +1,181 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveFirewallIpSet + +## SYNOPSIS +Creates a new firewall IP set. + +## SYNTAX + +``` +New-PveFirewallIpSet [-Level] [-Node ] [-VmId ] -Name [-Comment ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Creates a new firewall IP set at the specified level (Cluster, Node, Vm, or Container). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveFirewallIpSet -Level Cluster -Name trusted +``` + +Creates a cluster-level IP set named trusted. + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Optional comment for the IP set. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveFirewallIpSetEntry.md b/docs/cmdlets/New-PveFirewallIpSetEntry.md new file mode 100644 index 0000000..2ff5174 --- /dev/null +++ b/docs/cmdlets/New-PveFirewallIpSetEntry.md @@ -0,0 +1,212 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveFirewallIpSetEntry + +## SYNOPSIS +Adds an entry to a firewall IP set. + +## SYNTAX + +``` +New-PveFirewallIpSetEntry [-Level] [-Node ] [-VmId ] -Name + -Cidr [-NoMatch] [-Comment ] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Adds a new CIDR address entry to an existing firewall IP set. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveFirewallIpSetEntry -Level Cluster -Name trusted -Cidr 10.0.0.0/24 +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cidr +The CIDR network address to add. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -NoMatch +Exclude this entry from the IP set match. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Optional comment for the entry. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveFirewallRule.md b/docs/cmdlets/New-PveFirewallRule.md new file mode 100644 index 0000000..0bf782a --- /dev/null +++ b/docs/cmdlets/New-PveFirewallRule.md @@ -0,0 +1,337 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveFirewallRule + +## SYNOPSIS +Creates a new firewall rule. + +## SYNTAX + +``` +New-PveFirewallRule [-Level] [-Node ] [-VmId ] -Type -Action + [-Enable] [-Source ] [-Dest ] [-Proto ] [-Dport ] [-Sport ] + [-Comment ] [-Macro ] [-Log ] [-Iface ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Creates a new firewall rule at the specified level (Cluster, Node, Vm, or Container). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveFirewallRule -Level Cluster -Type in -Action ACCEPT -Proto tcp -Dport 443 -Enable +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The rule type: in, out, or group. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: in, out, group + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Action +The rule action: ACCEPT, DROP, or REJECT. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: ACCEPT, DROP, REJECT + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enable +Enable the rule. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Source +Source address or alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dest +Destination address or alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Proto +Protocol (e.g., tcp, udp, icmp). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dport +Destination port. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Sport +Source port. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Rule comment. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Macro +Macro name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Log +Log level. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Iface +Network interface. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Firewall.PveFirewallRule +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveGroup.md b/docs/cmdlets/New-PveGroup.md new file mode 100644 index 0000000..c11f7ca --- /dev/null +++ b/docs/cmdlets/New-PveGroup.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveGroup + +## SYNOPSIS +Creates a new Proxmox VE group. + +## SYNTAX + +``` +New-PveGroup [-GroupId] [-Comment ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Adds a new group to the Proxmox VE access management system. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveGroup -GroupId admins -Comment 'Admin group' +``` + +## PARAMETERS + +### -GroupId +The group identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Comment or description for the group. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Users.PveGroup +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PvePool.md b/docs/cmdlets/New-PvePool.md new file mode 100644 index 0000000..af97ded --- /dev/null +++ b/docs/cmdlets/New-PvePool.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PvePool + +## SYNOPSIS +Creates a new resource pool in Proxmox VE. + +## SYNTAX + +``` +New-PvePool [-PoolId] [-Comment ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Creates a new resource pool in the Proxmox VE cluster with the specified ID and optional comment. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PvePool -PoolId production -Comment 'Production VMs' +``` + +## PARAMETERS + +### -PoolId +The pool ID to create. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +An optional comment or description for the pool. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveSdnController.md b/docs/cmdlets/New-PveSdnController.md new file mode 100644 index 0000000..97c4b51 --- /dev/null +++ b/docs/cmdlets/New-PveSdnController.md @@ -0,0 +1,182 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveSdnController + +## SYNOPSIS +Creates a new SDN controller in Proxmox VE. + +## SYNTAX + +``` +New-PveSdnController [-Controller] [-Type] [-Asn ] [-Peers ] + [-Node ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Adds a new Software-Defined Networking controller. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveSdnController -Controller bgp1 -Type bgp -Asn 65001 +``` + +## PARAMETERS + +### -Controller +The controller identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The controller type. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: evpn, bgp + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Asn +The Autonomous System Number for BGP/EVPN. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Peers +Comma-separated list of BGP peer addresses. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node this controller is configured on. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveSdnDns.md b/docs/cmdlets/New-PveSdnDns.md new file mode 100644 index 0000000..bbbd601 --- /dev/null +++ b/docs/cmdlets/New-PveSdnDns.md @@ -0,0 +1,197 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveSdnDns + +## SYNOPSIS +Creates a new SDN DNS plugin in Proxmox VE. + +## SYNTAX + +``` +New-PveSdnDns [-Dns] [-Type] -Url -Key [-ReverseMaskV6 ] + [-Ttl ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Adds a new Software-Defined Networking DNS plugin. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveSdnDns -Dns pdns1 -Type powerdns -Url https://dns.example.com -Key mykey +``` + +## PARAMETERS + +### -Dns +The DNS plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The DNS plugin type. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: powerdns + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Url +The URL of the DNS service API. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Key +The API key for the DNS service. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReverseMaskV6 +The IPv6 reverse zone mask length. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Ttl +The TTL (time-to-live) for DNS records. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveSdnIpam.md b/docs/cmdlets/New-PveSdnIpam.md new file mode 100644 index 0000000..2654df3 --- /dev/null +++ b/docs/cmdlets/New-PveSdnIpam.md @@ -0,0 +1,181 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveSdnIpam + +## SYNOPSIS +Creates a new SDN IPAM plugin in Proxmox VE. + +## SYNTAX + +``` +New-PveSdnIpam [-Ipam] [-Type] [-Url ] [-Token ] [-Section ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Adds a new Software-Defined Networking IPAM plugin. Requires Proxmox VE 8.0 or later. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveSdnIpam -Ipam pveipam -Type pve +``` + +## PARAMETERS + +### -Ipam +The IPAM plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The IPAM plugin type. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: pve, netbox, phpipam + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Url +The URL of the external IPAM service. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Token +The API token for the external IPAM service. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Section +The configuration section identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/New-PveStorageDisk.md b/docs/cmdlets/New-PveStorageDisk.md new file mode 100644 index 0000000..e2e0c18 --- /dev/null +++ b/docs/cmdlets/New-PveStorageDisk.md @@ -0,0 +1,182 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# New-PveStorageDisk + +## SYNOPSIS +Allocates a new disk image on a Proxmox VE storage. + +## SYNTAX + +``` +New-PveStorageDisk [-Node] [-Storage] [-Filename] [-Size] + [-Format ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Creates a new disk image with the specified filename, size and optional format on the given storage and node. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-PveStorageDisk -Node pve1 -Storage local-lvm -Filename vm-100-disk-1 -Size 32G +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Filename +The filename for the new disk (e.g. vm-100-disk-1). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 2 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Size +The size of the disk (e.g. 32G, 100M). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 3 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Format +The disk image format (raw, qcow2, vmdk). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: raw, qcow2, vmdk + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.String +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Read-PveVmGuestFile.md b/docs/cmdlets/Read-PveVmGuestFile.md new file mode 100644 index 0000000..b04dbf1 --- /dev/null +++ b/docs/cmdlets/Read-PveVmGuestFile.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Read-PveVmGuestFile + +## SYNOPSIS +Reads a file from the guest filesystem via the QEMU guest agent. + +## SYNTAX + +``` +Read-PveVmGuestFile [-Node] [-VmId] -File [-Session ] + [-ProgressAction ] [] +``` + +## DESCRIPTION +Reads the contents of a file inside the guest operating system using the QEMU guest agent. The guest agent must be installed and running inside the VM. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Read-PveVmGuestFile -Node pve1 -VmId 100 -File /etc/hostname +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -File +The file path inside the guest to read. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.Int32 +## OUTPUTS + +### System.String +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveBackupJob.md b/docs/cmdlets/Remove-PveBackupJob.md new file mode 100644 index 0000000..66651ff --- /dev/null +++ b/docs/cmdlets/Remove-PveBackupJob.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveBackupJob + +## SYNOPSIS +Removes a scheduled backup job from Proxmox VE. + +## SYNTAX + +``` +Remove-PveBackupJob [-Id] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes a backup job from the Proxmox VE cluster configuration. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveBackupJob -Id "example" +``` + +## PARAMETERS + +### -Id +The backup job ID. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveDomain.md b/docs/cmdlets/Remove-PveDomain.md new file mode 100644 index 0000000..a998e7e --- /dev/null +++ b/docs/cmdlets/Remove-PveDomain.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveDomain + +## SYNOPSIS +Removes a Proxmox VE authentication domain/realm. + +## SYNTAX + +``` +Remove-PveDomain [-Realm] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified authentication domain (realm). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveDomain -Realm "example" +``` + +## PARAMETERS + +### -Realm +The realm identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveFirewallAlias.md b/docs/cmdlets/Remove-PveFirewallAlias.md new file mode 100644 index 0000000..0d758f8 --- /dev/null +++ b/docs/cmdlets/Remove-PveFirewallAlias.md @@ -0,0 +1,166 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveFirewallAlias + +## SYNOPSIS +Removes a firewall alias. + +## SYNTAX + +``` +Remove-PveFirewallAlias [-Level] [-Node ] [-VmId ] -Name + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Removes the specified firewall alias at the given level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveFirewallAlias -Level Cluster -Name myserver +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The alias name to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveFirewallGroup.md b/docs/cmdlets/Remove-PveFirewallGroup.md new file mode 100644 index 0000000..d586ec7 --- /dev/null +++ b/docs/cmdlets/Remove-PveFirewallGroup.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveFirewallGroup + +## SYNOPSIS +Removes a firewall security group. + +## SYNTAX + +``` +Remove-PveFirewallGroup [-Group] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Removes the specified firewall security group. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveFirewallGroup -Group webservers +``` + +## PARAMETERS + +### -Group +The security group name to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveFirewallIpSet.md b/docs/cmdlets/Remove-PveFirewallIpSet.md new file mode 100644 index 0000000..0081bc1 --- /dev/null +++ b/docs/cmdlets/Remove-PveFirewallIpSet.md @@ -0,0 +1,166 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveFirewallIpSet + +## SYNOPSIS +Removes a firewall IP set. + +## SYNTAX + +``` +Remove-PveFirewallIpSet [-Level] [-Node ] [-VmId ] -Name + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Removes the specified firewall IP set at the given level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveFirewallIpSet -Level Cluster -Name trusted +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveFirewallIpSetEntry.md b/docs/cmdlets/Remove-PveFirewallIpSetEntry.md new file mode 100644 index 0000000..caa17d6 --- /dev/null +++ b/docs/cmdlets/Remove-PveFirewallIpSetEntry.md @@ -0,0 +1,182 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveFirewallIpSetEntry + +## SYNOPSIS +Removes an entry from a firewall IP set. + +## SYNTAX + +``` +Remove-PveFirewallIpSetEntry [-Level] [-Node ] [-VmId ] -Name + -Cidr [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Removes the specified CIDR entry from a firewall IP set. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveFirewallIpSetEntry -Level Cluster -Name trusted -Cidr 10.0.0.0/24 +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cidr +The CIDR network address to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveFirewallRule.md b/docs/cmdlets/Remove-PveFirewallRule.md new file mode 100644 index 0000000..3c59b33 --- /dev/null +++ b/docs/cmdlets/Remove-PveFirewallRule.md @@ -0,0 +1,166 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveFirewallRule + +## SYNOPSIS +Removes a firewall rule. + +## SYNTAX + +``` +Remove-PveFirewallRule [-Level] [-Node ] [-VmId ] -Position + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Removes the firewall rule at the specified position and level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveFirewallRule -Level Cluster -Position 0 +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Position +The rule position to remove. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveGroup.md b/docs/cmdlets/Remove-PveGroup.md new file mode 100644 index 0000000..da7297f --- /dev/null +++ b/docs/cmdlets/Remove-PveGroup.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveGroup + +## SYNOPSIS +Removes a Proxmox VE group. + +## SYNTAX + +``` +Remove-PveGroup [-GroupId] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified group from the Proxmox VE access management system. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveGroup -GroupId "example" +``` + +## PARAMETERS + +### -GroupId +The group identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PvePool.md b/docs/cmdlets/Remove-PvePool.md new file mode 100644 index 0000000..5b40522 --- /dev/null +++ b/docs/cmdlets/Remove-PvePool.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PvePool + +## SYNOPSIS +Removes a resource pool from Proxmox VE. + +## SYNTAX + +``` +Remove-PvePool [-PoolId] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes a resource pool from the Proxmox VE cluster configuration. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PvePool -PoolId "example" +``` + +## PARAMETERS + +### -PoolId +The pool ID to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveSdnController.md b/docs/cmdlets/Remove-PveSdnController.md new file mode 100644 index 0000000..16dab4d --- /dev/null +++ b/docs/cmdlets/Remove-PveSdnController.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveSdnController + +## SYNOPSIS +Removes an SDN controller from Proxmox VE. + +## SYNTAX + +``` +Remove-PveSdnController [-Controller] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified Software-Defined Networking controller. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveSdnController -Controller "example" +``` + +## PARAMETERS + +### -Controller +The controller identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveSdnDns.md b/docs/cmdlets/Remove-PveSdnDns.md new file mode 100644 index 0000000..a2c7623 --- /dev/null +++ b/docs/cmdlets/Remove-PveSdnDns.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveSdnDns + +## SYNOPSIS +Removes an SDN DNS plugin from Proxmox VE. + +## SYNTAX + +``` +Remove-PveSdnDns [-Dns] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified Software-Defined Networking DNS plugin. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveSdnDns -Dns "example" +``` + +## PARAMETERS + +### -Dns +The DNS plugin identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveSdnIpam.md b/docs/cmdlets/Remove-PveSdnIpam.md new file mode 100644 index 0000000..df43ca7 --- /dev/null +++ b/docs/cmdlets/Remove-PveSdnIpam.md @@ -0,0 +1,119 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveSdnIpam + +## SYNOPSIS +Removes an SDN IPAM plugin from Proxmox VE. + +## SYNTAX + +``` +Remove-PveSdnIpam [-Ipam] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified Software-Defined Networking IPAM plugin. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveSdnIpam -Ipam "example" +``` + +## PARAMETERS + +### -Ipam +The IPAM plugin identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveStorageContent.md b/docs/cmdlets/Remove-PveStorageContent.md new file mode 100644 index 0000000..1b35d0e --- /dev/null +++ b/docs/cmdlets/Remove-PveStorageContent.md @@ -0,0 +1,149 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveStorageContent + +## SYNOPSIS +Removes a content volume from a Proxmox VE storage. + +## SYNTAX + +``` +Remove-PveStorageContent [-Node] [-Storage] [-Volume] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Deletes the specified volume from the storage on the given node. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveStorageContent -Node pve1 -Storage local -Volume "local:iso/ubuntu.iso" +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Volume +The volume identifier to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Remove-PveVmDisk.md b/docs/cmdlets/Remove-PveVmDisk.md new file mode 100644 index 0000000..2a589e8 --- /dev/null +++ b/docs/cmdlets/Remove-PveVmDisk.md @@ -0,0 +1,165 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Remove-PveVmDisk + +## SYNOPSIS +Removes (unlinks) disks from a QEMU/KVM virtual machine. + +## SYNTAX + +``` +Remove-PveVmDisk -Node -VmId -IdList [-Force] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Detaches and optionally destroys one or more disks from a virtual machine. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Remove-PveVmDisk -Node pve1 -VmId 100 -IdList scsi0 -Force +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -IdList +Comma-separated list of disk IDs to unlink (e.g. scsi0,scsi1). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Force +Force removal of disk images from storage. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Resize-PveContainerDisk.md b/docs/cmdlets/Resize-PveContainerDisk.md new file mode 100644 index 0000000..d3f3b1e --- /dev/null +++ b/docs/cmdlets/Resize-PveContainerDisk.md @@ -0,0 +1,165 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Resize-PveContainerDisk + +## SYNOPSIS +Resizes a disk attached to an LXC container. + +## SYNTAX + +``` +Resize-PveContainerDisk -Node -VmId -Disk -Size + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Resizes the specified disk/volume on an LXC container. Use an absolute size (e.g., '50G') or a relative size prefixed with '+' (e.g., '+5G'). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Resize-PveContainerDisk -Node pve1 -VmId 100 -Disk rootfs -Size +5G +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Disk +The disk/volume to resize (e.g. rootfs, mp0). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Size +New disk size (e.g. 50G or +5G to grow). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Resume-PveContainer.md b/docs/cmdlets/Resume-PveContainer.md new file mode 100644 index 0000000..2f28e3b --- /dev/null +++ b/docs/cmdlets/Resume-PveContainer.md @@ -0,0 +1,165 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Resume-PveContainer + +## SYNOPSIS +Resumes a suspended LXC container on a Proxmox VE node. + +## SYNTAX + +``` +Resume-PveContainer -Node -VmId [-Wait] [-Timeout ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Sends a resume command to the specified LXC container. Use -Wait to block until the resume task completes. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Resume-PveContainer -Node pve1 -VmId 100 -Wait +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Timeout +Timeout in seconds for -Wait (default 60). + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: 60 +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Send-PveFile.md b/docs/cmdlets/Send-PveFile.md new file mode 100644 index 0000000..13657ff --- /dev/null +++ b/docs/cmdlets/Send-PveFile.md @@ -0,0 +1,214 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Send-PveFile + +## SYNOPSIS +Uploads a local file to a Proxmox VE storage. + +## SYNTAX + +``` +Send-PveFile [-Node] [-Storage] [-Path] [[-ContentType] ] + [-Checksum ] [-ChecksumAlgorithm ] [-Wait] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Uploads a file from the local filesystem to the specified node/storage using the Proxmox VE upload API. Supports ISO images, container templates, and disk images for import. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Send-PveFile -Node pve1 -Storage local -Path ./ubuntu.iso -ContentType iso -Wait +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Path +Local path to the file to upload. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 2 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ContentType +Content type: iso, vztmpl, or import. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: iso, vztmpl, import + +Required: False +Position: 3 +Default value: iso +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Checksum +Checksum value to verify the upload. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ChecksumAlgorithm +Checksum algorithm (md5, sha1, sha256, sha512). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: md5, sha1, sha256, sha512 + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveApiToken.md b/docs/cmdlets/Set-PveApiToken.md new file mode 100644 index 0000000..315ec0d --- /dev/null +++ b/docs/cmdlets/Set-PveApiToken.md @@ -0,0 +1,180 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveApiToken + +## SYNOPSIS +Updates a Proxmox VE API token configuration. + +## SYNTAX + +``` +Set-PveApiToken [-UserId] [-TokenId] [-Comment ] [-Expire ] + [-PrivilegeSeparation] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Modifies properties of an existing API token such as its comment, expiration, or privilege separation setting. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveApiToken -UserId root@pam -TokenId mytoken -Comment 'Updated' +``` + +## PARAMETERS + +### -UserId +The user ID (e.g. 'user@realm'). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -TokenId +The token identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Comment +Comment describing the token. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Expire +Expiration as Unix epoch (0 = no expiration). + +```yaml +Type: Int64 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PrivilegeSeparation +Whether the token uses privilege separation. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveBackupJob.md b/docs/cmdlets/Set-PveBackupJob.md new file mode 100644 index 0000000..e616a75 --- /dev/null +++ b/docs/cmdlets/Set-PveBackupJob.md @@ -0,0 +1,307 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveBackupJob + +## SYNOPSIS +Updates a scheduled backup job on Proxmox VE. + +## SYNTAX + +``` +Set-PveBackupJob [-Id] [-Schedule ] [-Storage ] [-Mode ] + [-VmId ] [-All] [-Compress ] [-Node ] [-MailTo ] + [-MailNotification ] [-Enabled] [-Comment ] [-PruneBackups ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies properties of an existing backup job. Only specified parameters are updated. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveBackupJob -Id backup-abc -Schedule '0 3 * * *' +``` + +## PARAMETERS + +### -Id +The backup job ID. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Schedule +Cron-style schedule expression. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The target storage for backups. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode +The backup mode. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: snapshot, suspend, stop + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +Comma-separated list of VM IDs to back up. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -All +Back up all VMs. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Compress +The compression algorithm. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: zstd, lzo, gzip, none + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node to restrict the backup job to. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -MailTo +Email address(es) for notifications. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -MailNotification +When to send email notifications. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: always, failure + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enabled +Enable or disable the backup job. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +A comment or description for the backup job. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PruneBackups +Prune-backups configuration string. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveDomain.md b/docs/cmdlets/Set-PveDomain.md new file mode 100644 index 0000000..36939f4 --- /dev/null +++ b/docs/cmdlets/Set-PveDomain.md @@ -0,0 +1,149 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveDomain + +## SYNOPSIS +Updates a Proxmox VE authentication domain/realm. + +## SYNTAX + +``` +Set-PveDomain [-Realm] [-Comment ] [-Default] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies properties of an existing authentication domain (realm). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveDomain -Realm myldap -Comment 'Updated' +``` + +## PARAMETERS + +### -Realm +The realm identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Comment +Updated comment or description for the domain. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Default +Set as the default authentication domain. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveFirewallAlias.md b/docs/cmdlets/Set-PveFirewallAlias.md new file mode 100644 index 0000000..30fae8d --- /dev/null +++ b/docs/cmdlets/Set-PveFirewallAlias.md @@ -0,0 +1,197 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveFirewallAlias + +## SYNOPSIS +Updates a firewall alias. + +## SYNTAX + +``` +Set-PveFirewallAlias [-Level] [-Node ] [-VmId ] -Name [-Cidr ] + [-Comment ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Modifies the CIDR or comment of an existing firewall alias. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveFirewallAlias -Level Cluster -Name myserver -Cidr 10.0.0.2/32 +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The alias name to update. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cidr +The updated CIDR network address. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Updated comment for the alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveFirewallIpSetEntry.md b/docs/cmdlets/Set-PveFirewallIpSetEntry.md new file mode 100644 index 0000000..3a7a041 --- /dev/null +++ b/docs/cmdlets/Set-PveFirewallIpSetEntry.md @@ -0,0 +1,212 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveFirewallIpSetEntry + +## SYNOPSIS +Updates an entry in a firewall IP set. + +## SYNTAX + +``` +Set-PveFirewallIpSetEntry [-Level] [-Node ] [-VmId ] -Name + -Cidr [-NoMatch] [-Comment ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies properties of an existing entry in a firewall IP set. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveFirewallIpSetEntry -Level Cluster -Name trusted -Cidr 10.0.0.0/24 -Comment 'Updated' +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name +The IP set name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Cidr +The CIDR network address to update. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -NoMatch +Exclude this entry from the IP set match. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Updated comment for the entry. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveFirewallOptions.md b/docs/cmdlets/Set-PveFirewallOptions.md new file mode 100644 index 0000000..6ef639c --- /dev/null +++ b/docs/cmdlets/Set-PveFirewallOptions.md @@ -0,0 +1,292 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveFirewallOptions + +## SYNOPSIS +Updates firewall options at the specified level. + +## SYNTAX + +``` +Set-PveFirewallOptions [-Level] [-Node ] [-VmId ] [-Enable] + [-PolicyIn ] [-PolicyOut ] [-LogLevelIn ] [-LogLevelOut ] [-Dhcp] + [-Ndp] [-MacFilter] [-IpFilter] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies firewall configuration options at the Cluster, Node, Vm, or Container level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveFirewallOptions -Level Cluster -Enable -PolicyIn DROP +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enable +Enable or disable the firewall. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyIn +Default policy for incoming traffic. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: ACCEPT, DROP, REJECT + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyOut +Default policy for outgoing traffic. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: ACCEPT, DROP, REJECT + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -LogLevelIn +Log level for incoming traffic. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -LogLevelOut +Log level for outgoing traffic. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dhcp +Enable DHCP. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Ndp +Enable NDP. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -MacFilter +Enable MAC address filter. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IpFilter +Enable IP filter. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveFirewallRule.md b/docs/cmdlets/Set-PveFirewallRule.md new file mode 100644 index 0000000..06c8f90 --- /dev/null +++ b/docs/cmdlets/Set-PveFirewallRule.md @@ -0,0 +1,353 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveFirewallRule + +## SYNOPSIS +Updates a firewall rule. + +## SYNTAX + +``` +Set-PveFirewallRule [-Level] [-Node ] [-VmId ] -Position + [-Type ] [-Action ] [-Enable] [-Source ] [-Dest ] [-Proto ] + [-Dport ] [-Sport ] [-Comment ] [-Macro ] [-Log ] + [-Iface ] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Modifies properties of an existing firewall rule at the specified position and level. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveFirewallRule -Level Cluster -Position 0 -Enable +``` + +## PARAMETERS + +### -Level +The firewall level: Cluster, Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: Cluster, Node, Vm, Container + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node name. Required when Level is Node, Vm, or Container. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM/Container ID. Required when Level is Vm or Container. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Position +The rule position to update. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Type +The rule type: in, out, or group. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: in, out, group + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Action +The rule action: ACCEPT, DROP, or REJECT. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Accepted values: ACCEPT, DROP, REJECT + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enable +Enable the rule. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Source +Source address or alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dest +Destination address or alias. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Proto +Protocol (e.g., tcp, udp, icmp). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dport +Destination port. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Sport +Source port. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +Rule comment. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Macro +Macro name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Log +Log level. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Iface +Network interface. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveGroup.md b/docs/cmdlets/Set-PveGroup.md new file mode 100644 index 0000000..fdfa362 --- /dev/null +++ b/docs/cmdlets/Set-PveGroup.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveGroup + +## SYNOPSIS +Updates a Proxmox VE group. + +## SYNTAX + +``` +Set-PveGroup [-GroupId] [-Comment ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies properties of an existing group. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveGroup -GroupId admins -Comment 'Updated' +``` + +## PARAMETERS + +### -GroupId +The group identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Comment +Updated comment or description. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveNodeConfig.md b/docs/cmdlets/Set-PveNodeConfig.md new file mode 100644 index 0000000..e9a0ab6 --- /dev/null +++ b/docs/cmdlets/Set-PveNodeConfig.md @@ -0,0 +1,149 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveNodeConfig + +## SYNOPSIS +Updates the configuration of a Proxmox VE node. + +## SYNTAX + +``` +Set-PveNodeConfig [-Node] [-Description ] [-Wakeonlan ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies node-level configuration properties such as description and wake-on-LAN settings. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveNodeConfig -Node pve1 -Description 'Primary node' +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Description +Node description or comment. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Wakeonlan +Wake-on-LAN configuration. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveNodeDns.md b/docs/cmdlets/Set-PveNodeDns.md new file mode 100644 index 0000000..4d43369 --- /dev/null +++ b/docs/cmdlets/Set-PveNodeDns.md @@ -0,0 +1,179 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveNodeDns + +## SYNOPSIS +Updates the DNS configuration of a Proxmox VE node. + +## SYNTAX + +``` +Set-PveNodeDns [-Node] [-Search] [-Dns1 ] [-Dns2 ] [-Dns3 ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the DNS settings (search domain and nameservers) for the specified node. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveNodeDns -Node pve1 -Search example.com -Dns1 8.8.8.8 +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Search +The DNS search domain. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dns1 +Primary DNS server address. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dns2 +Secondary DNS server address. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Dns3 +Tertiary DNS server address. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PvePassword.md b/docs/cmdlets/Set-PvePassword.md new file mode 100644 index 0000000..f87add6 --- /dev/null +++ b/docs/cmdlets/Set-PvePassword.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PvePassword + +## SYNOPSIS +Changes a Proxmox VE user's password. + +## SYNTAX + +``` +Set-PvePassword [-UserId] [-Password] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Updates the password for the specified user. The password is accepted as a SecureString. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PvePassword -UserId admin@pve -Password (Read-Host -AsSecureString) +``` + +## PARAMETERS + +### -UserId +The user ID in user@realm format. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Password +The new password for the user. + +```yaml +Type: SecureString +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### None +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PvePool.md b/docs/cmdlets/Set-PvePool.md new file mode 100644 index 0000000..de67b8f --- /dev/null +++ b/docs/cmdlets/Set-PvePool.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PvePool + +## SYNOPSIS +Updates a resource pool in Proxmox VE. + +## SYNTAX + +``` +Set-PvePool [-PoolId] [-Comment ] [-Members ] [-Delete ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies an existing resource pool configuration. You can update the comment, add members, or remove members. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PvePool -PoolId production -Comment 'Updated' +``` + +## PARAMETERS + +### -PoolId +The pool ID to update. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Comment +An optional comment or description. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Members +Comma-separated list of members to add. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Delete +Comma-separated list of members to remove. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveRole.md b/docs/cmdlets/Set-PveRole.md new file mode 100644 index 0000000..13555a1 --- /dev/null +++ b/docs/cmdlets/Set-PveRole.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveRole + +## SYNOPSIS +Updates a Proxmox VE role's privileges. + +## SYNTAX + +``` +Set-PveRole [-RoleId] [-Privileges] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the privilege set for an existing custom role. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveRole -RoleId MyRole -Privileges 'VM.Audit,VM.Console' +``` + +## PARAMETERS + +### -RoleId +The role identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Privileges +Comma-separated list of privileges. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnController.md b/docs/cmdlets/Set-PveSdnController.md new file mode 100644 index 0000000..9502787 --- /dev/null +++ b/docs/cmdlets/Set-PveSdnController.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnController + +## SYNOPSIS +Updates an SDN controller configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnController [-Controller] [-Asn ] [-Peers ] [-Node ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN controller configuration. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnController -Controller bgp1 -Asn 65002 +``` + +## PARAMETERS + +### -Controller +The SDN controller identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Asn +The Autonomous System Number for BGP/EVPN. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Peers +Comma-separated list of BGP peer addresses. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Node +The node this controller is configured on. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnDns.md b/docs/cmdlets/Set-PveSdnDns.md new file mode 100644 index 0000000..56a2045 --- /dev/null +++ b/docs/cmdlets/Set-PveSdnDns.md @@ -0,0 +1,179 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnDns + +## SYNOPSIS +Updates an SDN DNS plugin configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnDns [-Dns] [-Url ] [-Key ] [-ReverseMaskV6 ] [-Ttl ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN DNS plugin configuration. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnDns -Dns pdns1 -Url https://dns2.example.com +``` + +## PARAMETERS + +### -Dns +The SDN DNS plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Url +The DNS server URL. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Key +The TSIG key for DNS updates. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReverseMaskV6 +The IPv6 reverse DNS mask length. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Ttl +The TTL for DNS records. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnIpam.md b/docs/cmdlets/Set-PveSdnIpam.md new file mode 100644 index 0000000..d5b6541 --- /dev/null +++ b/docs/cmdlets/Set-PveSdnIpam.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnIpam + +## SYNOPSIS +Updates an SDN IPAM plugin configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnIpam [-Ipam] [-Url ] [-Token ] [-Section ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN IPAM plugin configuration. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnIpam -Ipam myipam -Url https://ipam.example.com +``` + +## PARAMETERS + +### -Ipam +The SDN IPAM plugin identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Url +The IPAM server URL. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Token +The API token for the IPAM server. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Section +The section ID in the IPAM server. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnSubnet.md b/docs/cmdlets/Set-PveSdnSubnet.md new file mode 100644 index 0000000..861e82b --- /dev/null +++ b/docs/cmdlets/Set-PveSdnSubnet.md @@ -0,0 +1,195 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnSubnet + +## SYNOPSIS +Updates an SDN subnet configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnSubnet [-Vnet] [-Subnet] [-Gateway ] [-Snat] + [-DnsZonePrefix ] [-DhcpRange ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN subnet configuration on a VNet. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnSubnet -Vnet myvnet -Subnet 10.0.0.0/24 -Gateway 10.0.0.1 +``` + +## PARAMETERS + +### -Vnet +The SDN VNet name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Subnet +The subnet CIDR. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Gateway +Gateway address for this subnet. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Snat +Enable SNAT for this subnet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DnsZonePrefix +DNS zone prefix for automatic registration. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DhcpRange +DHCP range for this subnet. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnVnet.md b/docs/cmdlets/Set-PveSdnVnet.md new file mode 100644 index 0000000..072526f --- /dev/null +++ b/docs/cmdlets/Set-PveSdnVnet.md @@ -0,0 +1,179 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnVnet + +## SYNOPSIS +Updates an SDN VNet configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnVnet [-Vnet] [-Alias ] [-Zone ] [-Tag ] [-VlanAware] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN VNet configuration. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnVnet -Vnet myvnet -Zone myzone +``` + +## PARAMETERS + +### -Vnet +The SDN VNet name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Alias +An alias for the VNet. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Zone +The zone this VNet belongs to. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Tag +VLAN tag for this VNet. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VlanAware +Enable VLAN-aware bridging. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveSdnZone.md b/docs/cmdlets/Set-PveSdnZone.md new file mode 100644 index 0000000..07609c8 --- /dev/null +++ b/docs/cmdlets/Set-PveSdnZone.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveSdnZone + +## SYNOPSIS +Updates an SDN zone configuration in Proxmox VE. + +## SYNTAX + +``` +Set-PveSdnZone [-Zone] [-Dns ] [-Reversedns ] [-DnsZone ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the specified SDN zone configuration. Changes are pending until Invoke-PveSdnApply is called. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveSdnZone -Zone myzone -Dns pdns1 +``` + +## PARAMETERS + +### -Zone +The SDN zone name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Dns +DNS server for automatic registration. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Reversedns +Reverse DNS server. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DnsZone +DNS zone name for registration. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveStorage.md b/docs/cmdlets/Set-PveStorage.md new file mode 100644 index 0000000..5487234 --- /dev/null +++ b/docs/cmdlets/Set-PveStorage.md @@ -0,0 +1,195 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveStorage + +## SYNOPSIS +Updates a Proxmox VE storage definition. + +## SYNTAX + +``` +Set-PveStorage [-Storage] [-Content ] [-Nodes ] [-Enabled] [-Shared] + [-AdditionalConfig ] [-Session ] [-ProgressAction ] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies the configuration of an existing storage definition. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveStorage -Storage local -Content 'images,iso,backup' +``` + +## PARAMETERS + +### -Storage +The storage identifier. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Content +Comma-separated content types. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Nodes +Comma-separated list of nodes. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Enabled +Whether the storage is enabled. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Shared +Whether the storage is shared. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AdditionalConfig +Additional configuration parameters as a hashtable. + +```yaml +Type: Hashtable +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveStorageContent.md b/docs/cmdlets/Set-PveStorageContent.md new file mode 100644 index 0000000..a2db146 --- /dev/null +++ b/docs/cmdlets/Set-PveStorageContent.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveStorageContent + +## SYNOPSIS +Updates properties of a content volume in Proxmox VE storage. + +## SYNTAX + +``` +Set-PveStorageContent [-Node] [-Storage] [-Volume] [-Notes ] + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Modifies metadata (such as notes/description) of an existing volume. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveStorageContent -Node pve1 -Storage local -Volume 'local:iso/ubuntu.iso' -Notes 'Ubuntu 24.04' +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Storage +The storage pool name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Volume +The volume identifier to update. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 2 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Notes +Notes or description for the volume. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Set-PveVmGuestPassword.md b/docs/cmdlets/Set-PveVmGuestPassword.md new file mode 100644 index 0000000..1209e4d --- /dev/null +++ b/docs/cmdlets/Set-PveVmGuestPassword.md @@ -0,0 +1,180 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Set-PveVmGuestPassword + +## SYNOPSIS +Sets a user password inside the guest via the QEMU guest agent. + +## SYNTAX + +``` +Set-PveVmGuestPassword [-Node] [-VmId] -Username -Password + [-Crypted] [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] + [] +``` + +## DESCRIPTION +Changes a user's password inside the guest operating system using the QEMU guest agent. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Set-PveVmGuestPassword -Node pve1 -VmId 100 -Username root -Password (Read-Host -AsSecureString) +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Username +The username whose password to set. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Password +The new password. + +```yaml +Type: SecureString +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Crypted +Indicates the password is already crypted/hashed. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.Int32 +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Start-PveNodeVms.md b/docs/cmdlets/Start-PveNodeVms.md new file mode 100644 index 0000000..410e243 --- /dev/null +++ b/docs/cmdlets/Start-PveNodeVms.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Start-PveNodeVms + +## SYNOPSIS +Starts all VMs and containers on a Proxmox VE node. + +## SYNTAX + +``` +Start-PveNodeVms [-Node] [-VmIds ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Triggers the start-all operation on the specified node. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Start-PveNodeVms -Node pve1 +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmIds +Comma-separated list of VM IDs to start. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Stop-PveNodeVms.md b/docs/cmdlets/Stop-PveNodeVms.md new file mode 100644 index 0000000..e89d442 --- /dev/null +++ b/docs/cmdlets/Stop-PveNodeVms.md @@ -0,0 +1,149 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Stop-PveNodeVms + +## SYNOPSIS +Stops all VMs and containers on a Proxmox VE node. + +## SYNTAX + +``` +Stop-PveNodeVms [-Node] [-VmIds ] [-ForceStop] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Triggers the stop-all operation on the specified node. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Stop-PveNodeVms -Node pve1 +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmIds +Comma-separated list of VM IDs to stop. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ForceStop +Force stop VMs without waiting for graceful shutdown. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Stop-PveTask.md b/docs/cmdlets/Stop-PveTask.md new file mode 100644 index 0000000..0a2880b --- /dev/null +++ b/docs/cmdlets/Stop-PveTask.md @@ -0,0 +1,134 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Stop-PveTask + +## SYNOPSIS +Stops a running task on a Proxmox VE node. + +## SYNTAX + +``` +Stop-PveTask [-Node] [-Upid] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Cancels a running task identified by its UPID. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Stop-PveTask -Node pve1 -Upid 'UPID:pve1:...' +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Upid +The task UPID. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Suspend-PveContainer.md b/docs/cmdlets/Suspend-PveContainer.md new file mode 100644 index 0000000..ebf39d4 --- /dev/null +++ b/docs/cmdlets/Suspend-PveContainer.md @@ -0,0 +1,165 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Suspend-PveContainer + +## SYNOPSIS +Suspends an LXC container on a Proxmox VE node. + +## SYNTAX + +``` +Suspend-PveContainer -Node -VmId [-Wait] [-Timeout ] [-Session ] + [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Sends a suspend command to the specified LXC container. Use -Wait to block until the suspend task completes. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Suspend-PveContainer -Node pve1 -VmId 100 -Wait +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -VmId +The container identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -Wait +Wait for the task to complete before returning. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Timeout +Timeout in seconds for -Wait (default 60). + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: 60 +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.String +### System.Int32 +## OUTPUTS + +### PSProxmoxVE.Core.Models.Vms.PveTask +## NOTES + +## RELATED LINKS diff --git a/docs/cmdlets/Write-PveVmGuestFile.md b/docs/cmdlets/Write-PveVmGuestFile.md new file mode 100644 index 0000000..6aa62ed --- /dev/null +++ b/docs/cmdlets/Write-PveVmGuestFile.md @@ -0,0 +1,164 @@ +--- +external help file: PSProxmoxVE.dll-Help.xml +Module Name: PSProxmoxVE +online version: +schema: 2.0.0 +--- + +# Write-PveVmGuestFile + +## SYNOPSIS +Writes content to a file on the guest filesystem via the QEMU guest agent. + +## SYNTAX + +``` +Write-PveVmGuestFile [-Node] [-VmId] -File -Content + [-Session ] [-ProgressAction ] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +Writes the specified content to a file inside the guest operating system using the QEMU guest agent. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Write-PveVmGuestFile -Node pve1 -VmId 100 -File /tmp/test.txt -Content 'Hello World' +``` + +## PARAMETERS + +### -Node +The PVE node name. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -VmId +The VM identifier. + +```yaml +Type: Int32 +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -File +The file path inside the guest to write. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Content +The content to write to the file. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Session +{{ Fill Session Description }} + +```yaml +Type: PveSession +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProgressAction +{{ Fill ProgressAction Description }} + +```yaml +Type: ActionPreference +Parameter Sets: (All) +Aliases: proga + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + + +## INPUTS + +### System.Int32 +## OUTPUTS + +### System.Void +## NOTES + +## RELATED LINKS diff --git a/src/PSProxmoxVE.Core/PSProxmoxVE.Core.csproj b/src/PSProxmoxVE.Core/PSProxmoxVE.Core.csproj index 0e7c981..857e74e 100644 --- a/src/PSProxmoxVE.Core/PSProxmoxVE.Core.csproj +++ b/src/PSProxmoxVE.Core/PSProxmoxVE.Core.csproj @@ -1,7 +1,7 @@ - netstandard2.0;net9.0;net48 + netstandard2.0;net10.0;net48 10.0 enable PSProxmoxVE.Core @@ -18,18 +18,16 @@ - - - + diff --git a/src/PSProxmoxVE/Cmdlets/CloudInit/GetPveCloudInitConfigCmdlet.cs b/src/PSProxmoxVE/Cmdlets/CloudInit/GetPveCloudInitConfigCmdlet.cs index 90d965f..5f9e8d7 100644 --- a/src/PSProxmoxVE/Cmdlets/CloudInit/GetPveCloudInitConfigCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/CloudInit/GetPveCloudInitConfigCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; @@ -33,7 +34,7 @@ namespace PSProxmoxVE.Cmdlets.CloudInit using var client = new PveHttpClient(session); WriteVerbose($"Getting cloud-init config for VM {VmId}..."); - var json = client.GetAsync($"nodes/{Node}/qemu/{VmId}/config").GetAwaiter().GetResult(); + var json = client.GetAsync($"nodes/{Uri.EscapeDataString(Node)}/qemu/{VmId}/config").GetAwaiter().GetResult(); var root = JObject.Parse(json); var data = root["data"]; diff --git a/src/PSProxmoxVE/Cmdlets/Containers/NewPveContainerSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Containers/NewPveContainerSnapshotCmdlet.cs index 68d02f1..d23ca1d 100644 --- a/src/PSProxmoxVE/Cmdlets/Containers/NewPveContainerSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Containers/NewPveContainerSnapshotCmdlet.cs @@ -4,6 +4,7 @@ using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; using PSProxmoxVE.Core.Models.Vms; +using PSProxmoxVE.Core.Services; namespace PSProxmoxVE.Cmdlets.Containers { @@ -54,7 +55,7 @@ namespace PSProxmoxVE.Cmdlets.Containers }; if (!string.IsNullOrEmpty(Description)) data["description"] = Description!; - var json = client.PostAsync($"nodes/{Node}/lxc/{VmId}/snapshot", data).GetAwaiter().GetResult(); + var json = client.PostAsync($"nodes/{Uri.EscapeDataString(Node)}/lxc/{VmId}/snapshot", data).GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; @@ -62,25 +63,11 @@ namespace PSProxmoxVE.Cmdlets.Containers if (Wait.IsPresent && !string.IsNullOrEmpty(upid)) { - task = WaitForTask(client, Node, upid); + var taskService = new TaskService(); + task = taskService.WaitForTask(session, Node, upid); } WriteObject(task); } - - private static PveTask WaitForTask(PveHttpClient client, string node, string upid) - { - var encodedUpid = Uri.EscapeDataString(upid); - var statusResource = $"nodes/{node}/tasks/{encodedUpid}/status"; - while (true) - { - System.Threading.Thread.Sleep(2000); - var statusJson = client.GetAsync(statusResource).GetAwaiter().GetResult(); - var statusRoot = JObject.Parse(statusJson); - var d = statusRoot["data"]; - if (d?["status"]?.ToString() == "stopped") - return new PveTask { Upid = upid, Node = node, Status = "stopped", ExitStatus = d["exitstatus"]?.ToString() }; - } - } } } diff --git a/src/PSProxmoxVE/Cmdlets/Containers/RemovePveContainerSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Containers/RemovePveContainerSnapshotCmdlet.cs index 30ee73b..3c10e0f 100644 --- a/src/PSProxmoxVE/Cmdlets/Containers/RemovePveContainerSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Containers/RemovePveContainerSnapshotCmdlet.cs @@ -3,6 +3,7 @@ using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; using PSProxmoxVE.Core.Models.Vms; +using PSProxmoxVE.Core.Services; namespace PSProxmoxVE.Cmdlets.Containers { @@ -46,7 +47,7 @@ namespace PSProxmoxVE.Cmdlets.Containers WriteVerbose($"Removing snapshot '{Name}' from container {VmId}..."); using var client = new PveHttpClient(session); - var json = client.DeleteAsync($"nodes/{Node}/lxc/{VmId}/snapshot/{Name}").GetAwaiter().GetResult(); + var json = client.DeleteAsync($"nodes/{Uri.EscapeDataString(Node)}/lxc/{VmId}/snapshot/{Uri.EscapeDataString(Name)}").GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; @@ -54,25 +55,11 @@ namespace PSProxmoxVE.Cmdlets.Containers if (Wait.IsPresent && !string.IsNullOrEmpty(upid)) { - task = WaitForTask(client, Node, upid); + var taskService = new TaskService(); + task = taskService.WaitForTask(session, Node, upid); } WriteObject(task); } - - private static PveTask WaitForTask(PveHttpClient client, string node, string upid) - { - var encodedUpid = Uri.EscapeDataString(upid); - var statusResource = $"nodes/{node}/tasks/{encodedUpid}/status"; - while (true) - { - System.Threading.Thread.Sleep(2000); - var statusJson = client.GetAsync(statusResource).GetAwaiter().GetResult(); - var statusRoot = JObject.Parse(statusJson); - var d = statusRoot["data"]; - if (d?["status"]?.ToString() == "stopped") - return new PveTask { Upid = upid, Node = node, Status = "stopped", ExitStatus = d["exitstatus"]?.ToString() }; - } - } } } diff --git a/src/PSProxmoxVE/Cmdlets/Containers/RestartPveContainerCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Containers/RestartPveContainerCmdlet.cs index c59caec..efb3020 100644 --- a/src/PSProxmoxVE/Cmdlets/Containers/RestartPveContainerCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Containers/RestartPveContainerCmdlet.cs @@ -12,7 +12,7 @@ namespace PSProxmoxVE.Cmdlets.Containers /// Use -Wait to block until both tasks complete. /// /// - [Cmdlet(VerbsLifecycle.Restart, "PveContainer", SupportsShouldProcess = true)] + [Cmdlet(VerbsLifecycle.Restart, "PveContainer", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.High)] [OutputType(typeof(PveTask))] public sealed class RestartPveContainerCmdlet : PveCmdletBase { diff --git a/src/PSProxmoxVE/Cmdlets/Containers/RestorePveContainerSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Containers/RestorePveContainerSnapshotCmdlet.cs index 7c8dde8..8a4a1c9 100644 --- a/src/PSProxmoxVE/Cmdlets/Containers/RestorePveContainerSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Containers/RestorePveContainerSnapshotCmdlet.cs @@ -3,6 +3,7 @@ using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; using PSProxmoxVE.Core.Models.Vms; +using PSProxmoxVE.Core.Services; namespace PSProxmoxVE.Cmdlets.Containers { @@ -49,7 +50,7 @@ namespace PSProxmoxVE.Cmdlets.Containers WriteVerbose($"Restoring snapshot '{Name}' on container {VmId}..."); using var client = new PveHttpClient(session); - var json = client.PostAsync($"nodes/{Node}/lxc/{VmId}/snapshot/{Name}/rollback").GetAwaiter().GetResult(); + var json = client.PostAsync($"nodes/{Uri.EscapeDataString(Node)}/lxc/{VmId}/snapshot/{Uri.EscapeDataString(Name)}/rollback").GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; @@ -57,25 +58,11 @@ namespace PSProxmoxVE.Cmdlets.Containers if (Wait.IsPresent && !string.IsNullOrEmpty(upid)) { - task = WaitForTask(client, Node, upid); + var taskService = new TaskService(); + task = taskService.WaitForTask(session, Node, upid); } WriteObject(task); } - - private static PveTask WaitForTask(PveHttpClient client, string node, string upid) - { - var encodedUpid = Uri.EscapeDataString(upid); - var statusResource = $"nodes/{node}/tasks/{encodedUpid}/status"; - while (true) - { - System.Threading.Thread.Sleep(2000); - var statusJson = client.GetAsync(statusResource).GetAwaiter().GetResult(); - var statusRoot = JObject.Parse(statusJson); - var d = statusRoot["data"]; - if (d?["status"]?.ToString() == "stopped") - return new PveTask { Upid = upid, Node = node, Status = "stopped", ExitStatus = d["exitstatus"]?.ToString() }; - } - } } } diff --git a/src/PSProxmoxVE/Cmdlets/Containers/SuspendPveContainerCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Containers/SuspendPveContainerCmdlet.cs index b5f2542..92927c8 100644 --- a/src/PSProxmoxVE/Cmdlets/Containers/SuspendPveContainerCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Containers/SuspendPveContainerCmdlet.cs @@ -11,7 +11,7 @@ namespace PSProxmoxVE.Cmdlets.Containers /// Use -Wait to block until the suspend task completes. /// /// - [Cmdlet(VerbsLifecycle.Suspend, "PveContainer", SupportsShouldProcess = true)] + [Cmdlet(VerbsLifecycle.Suspend, "PveContainer", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.High)] [OutputType(typeof(PveTask))] public sealed class SuspendPveContainerCmdlet : PveCmdletBase { diff --git a/src/PSProxmoxVE/Cmdlets/Network/GetPveNetworkCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Network/GetPveNetworkCmdlet.cs index 180c837..bfabaeb 100644 --- a/src/PSProxmoxVE/Cmdlets/Network/GetPveNetworkCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Network/GetPveNetworkCmdlet.cs @@ -40,7 +40,7 @@ namespace PSProxmoxVE.Cmdlets.Network using var client = new PveHttpClient(session); WriteVerbose($"Getting network interfaces on node '{Node}'..."); - var resource = $"nodes/{Node}/network"; + var resource = $"nodes/{Uri.EscapeDataString(Node)}/network"; if (!string.IsNullOrEmpty(Type)) resource += $"?type={Uri.EscapeDataString(Type)}"; diff --git a/src/PSProxmoxVE/Cmdlets/Network/InvokePveNetworkApplyCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Network/InvokePveNetworkApplyCmdlet.cs index 330455e..12c397d 100644 --- a/src/PSProxmoxVE/Cmdlets/Network/InvokePveNetworkApplyCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Network/InvokePveNetworkApplyCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; @@ -35,7 +36,7 @@ namespace PSProxmoxVE.Cmdlets.Network using var client = new PveHttpClient(session); WriteVerbose($"Applying network configuration on node '{Node}'..."); - var json = client.PutAsync($"nodes/{Node}/network").GetAwaiter().GetResult(); + var json = client.PutAsync($"nodes/{Uri.EscapeDataString(Node)}/network").GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; diff --git a/src/PSProxmoxVE/Cmdlets/Network/NewPveNetworkCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Network/NewPveNetworkCmdlet.cs index 8887ff9..b04b8a8 100644 --- a/src/PSProxmoxVE/Cmdlets/Network/NewPveNetworkCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Network/NewPveNetworkCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Collections.Generic; using System.Management.Automation; using PSProxmoxVE.Core.Client; @@ -90,7 +91,7 @@ namespace PSProxmoxVE.Cmdlets.Network if (Autostart.IsPresent) data["autostart"] = "1"; if (!string.IsNullOrEmpty(Comments)) data["comments"] = Comments!; - client.PostAsync($"nodes/{Node}/network", data).GetAwaiter().GetResult(); + client.PostAsync($"nodes/{Uri.EscapeDataString(Node)}/network", data).GetAwaiter().GetResult(); } } } diff --git a/src/PSProxmoxVE/Cmdlets/Network/RemovePveNetworkCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Network/RemovePveNetworkCmdlet.cs index cb3e6f0..ab17206 100644 --- a/src/PSProxmoxVE/Cmdlets/Network/RemovePveNetworkCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Network/RemovePveNetworkCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Management.Automation; using PSProxmoxVE.Core.Client; @@ -31,7 +32,7 @@ namespace PSProxmoxVE.Cmdlets.Network using var client = new PveHttpClient(session); WriteVerbose($"Removing network interface '{Iface}' on node '{Node}'..."); - client.DeleteAsync($"nodes/{Node}/network/{Iface}").GetAwaiter().GetResult(); + client.DeleteAsync($"nodes/{Uri.EscapeDataString(Node)}/network/{Uri.EscapeDataString(Iface)}").GetAwaiter().GetResult(); } } } diff --git a/src/PSProxmoxVE/Cmdlets/Network/SetPveNetworkCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Network/SetPveNetworkCmdlet.cs index 8b86c62..4405e81 100644 --- a/src/PSProxmoxVE/Cmdlets/Network/SetPveNetworkCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Network/SetPveNetworkCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Collections.Generic; using System.Management.Automation; using PSProxmoxVE.Core.Client; @@ -97,7 +98,7 @@ namespace PSProxmoxVE.Cmdlets.Network if (Autostart.IsPresent) data["autostart"] = "1"; if (!string.IsNullOrEmpty(Comments)) data["comments"] = Comments!; - client.PutAsync($"nodes/{Node}/network/{Iface}", data).GetAwaiter().GetResult(); + client.PutAsync($"nodes/{Uri.EscapeDataString(Node)}/network/{Uri.EscapeDataString(Iface)}", data).GetAwaiter().GetResult(); } } } diff --git a/src/PSProxmoxVE/Cmdlets/PveCmdletBase.cs b/src/PSProxmoxVE/Cmdlets/PveCmdletBase.cs index 6a5c795..40b38f0 100644 --- a/src/PSProxmoxVE/Cmdlets/PveCmdletBase.cs +++ b/src/PSProxmoxVE/Cmdlets/PveCmdletBase.cs @@ -126,8 +126,8 @@ namespace PSProxmoxVE.Cmdlets // because it returns qmpstatus (needed for paused state detection — PVE reports // status=running but qmpstatus=paused for suspended VMs). var statusResource = isContainer - ? $"nodes/{node}/lxc/{vmid}/status/current" - : $"nodes/{node}/qemu/{vmid}/status/current"; + ? $"nodes/{Uri.EscapeDataString(node)}/lxc/{vmid}/status/current" + : $"nodes/{Uri.EscapeDataString(node)}/qemu/{vmid}/status/current"; var deadline = DateTime.UtcNow.AddSeconds(timeoutSeconds); using var pollClient = new PveHttpClient(session); diff --git a/src/PSProxmoxVE/Cmdlets/Snapshots/NewPveSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Snapshots/NewPveSnapshotCmdlet.cs index e5d1dab..8231d3f 100644 --- a/src/PSProxmoxVE/Cmdlets/Snapshots/NewPveSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Snapshots/NewPveSnapshotCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Collections.Generic; using System.Management.Automation; using Newtonsoft.Json.Linq; @@ -59,7 +60,7 @@ namespace PSProxmoxVE.Cmdlets.Snapshots if (!string.IsNullOrEmpty(Description)) data["description"] = Description!; if (IncludeVmState.IsPresent) data["vmstate"] = "1"; - var json = client.PostAsync($"nodes/{Node}/qemu/{VmId}/snapshot", data).GetAwaiter().GetResult(); + var json = client.PostAsync($"nodes/{Uri.EscapeDataString(Node)}/qemu/{VmId}/snapshot", data).GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; diff --git a/src/PSProxmoxVE/Cmdlets/Snapshots/RemovePveSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Snapshots/RemovePveSnapshotCmdlet.cs index bddf737..ca66bd2 100644 --- a/src/PSProxmoxVE/Cmdlets/Snapshots/RemovePveSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Snapshots/RemovePveSnapshotCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; @@ -46,7 +47,7 @@ namespace PSProxmoxVE.Cmdlets.Snapshots WriteVerbose($"Removing snapshot '{Name}' from VM {VmId}..."); using var client = new PveHttpClient(session); - var json = client.DeleteAsync($"nodes/{Node}/qemu/{VmId}/snapshot/{Name}").GetAwaiter().GetResult(); + var json = client.DeleteAsync($"nodes/{Uri.EscapeDataString(Node)}/qemu/{VmId}/snapshot/{Uri.EscapeDataString(Name)}").GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; diff --git a/src/PSProxmoxVE/Cmdlets/Snapshots/RestorePveSnapshotCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Snapshots/RestorePveSnapshotCmdlet.cs index a8dd9e2..d987337 100644 --- a/src/PSProxmoxVE/Cmdlets/Snapshots/RestorePveSnapshotCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Snapshots/RestorePveSnapshotCmdlet.cs @@ -1,3 +1,4 @@ +using System; using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; @@ -49,7 +50,7 @@ namespace PSProxmoxVE.Cmdlets.Snapshots WriteVerbose($"Restoring snapshot '{Name}' on VM {VmId}..."); using var client = new PveHttpClient(session); - var json = client.PostAsync($"nodes/{Node}/qemu/{VmId}/snapshot/{Name}/rollback").GetAwaiter().GetResult(); + var json = client.PostAsync($"nodes/{Uri.EscapeDataString(Node)}/qemu/{VmId}/snapshot/{Uri.EscapeDataString(Name)}/rollback").GetAwaiter().GetResult(); var root = JObject.Parse(json); var upid = root["data"]?.ToString() ?? string.Empty; diff --git a/src/PSProxmoxVE/Cmdlets/Storage/InvokePveStorageDownloadCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Storage/InvokePveStorageDownloadCmdlet.cs index b1ea6f8..9637391 100644 --- a/src/PSProxmoxVE/Cmdlets/Storage/InvokePveStorageDownloadCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Storage/InvokePveStorageDownloadCmdlet.cs @@ -4,6 +4,7 @@ using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; using PSProxmoxVE.Core.Models.Vms; +using PSProxmoxVE.Core.Services; namespace PSProxmoxVE.Cmdlets.Storage { @@ -53,7 +54,7 @@ namespace PSProxmoxVE.Cmdlets.Storage using var client = new PveHttpClient(session); WriteVerbose($"Downloading '{Url}' to {Node}/{Storage}..."); - var resource = $"nodes/{Node}/storage/{Storage}/download-url"; + var resource = $"nodes/{Uri.EscapeDataString(Node)}/storage/{Uri.EscapeDataString(Storage)}/download-url"; var data = new Dictionary { ["url"] = Url, @@ -69,37 +70,11 @@ namespace PSProxmoxVE.Cmdlets.Storage if (Wait.IsPresent && !string.IsNullOrEmpty(upid)) { - task = WaitForTask(client, Node, upid); + var taskService = new TaskService(); + task = taskService.WaitForTask(session, Node, upid); } WriteObject(task); } - - private static PveTask WaitForTask(PveHttpClient client, string node, string upid) - { - var encodedUpid = Uri.EscapeDataString(upid); - var statusResource = $"nodes/{node}/tasks/{encodedUpid}/status"; - - while (true) - { - System.Threading.Thread.Sleep(2000); - var statusJson = client.GetAsync(statusResource).GetAwaiter().GetResult(); - var statusRoot = JObject.Parse(statusJson); - var data = statusRoot["data"]; - var status = data?["status"]?.ToString(); - var exitStatus = data?["exitstatus"]?.ToString(); - - if (status == "stopped") - { - return new PveTask - { - Upid = upid, - Node = node, - Status = status, - ExitStatus = exitStatus - }; - } - } - } } } diff --git a/src/PSProxmoxVE/Cmdlets/Storage/SendPveFileCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Storage/SendPveFileCmdlet.cs index 536427e..776d2e5 100644 --- a/src/PSProxmoxVE/Cmdlets/Storage/SendPveFileCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Storage/SendPveFileCmdlet.cs @@ -4,6 +4,7 @@ using System.Management.Automation; using Newtonsoft.Json.Linq; using PSProxmoxVE.Core.Client; using PSProxmoxVE.Core.Models.Vms; +using PSProxmoxVE.Core.Services; namespace PSProxmoxVE.Cmdlets.Storage { @@ -77,7 +78,7 @@ namespace PSProxmoxVE.Cmdlets.Storage using var client = new PveHttpClient(session); WriteVerbose($"Uploading {fileName} to {Node}/{Storage} (content={ContentType})..."); - var resource = $"nodes/{Node}/storage/{Storage}/upload"; + var resource = $"nodes/{Uri.EscapeDataString(Node)}/storage/{Uri.EscapeDataString(Storage)}/upload"; var totalBytes = new System.IO.FileInfo(Path).Length; var activityId = 1; @@ -129,38 +130,12 @@ namespace PSProxmoxVE.Cmdlets.Storage if (Wait.IsPresent && !string.IsNullOrEmpty(upid)) { - task = WaitForTask(client, Node, upid); + var taskService = new TaskService(); + task = taskService.WaitForTask(session, Node, upid); } WriteObject(task); } - - private static PveTask WaitForTask(PveHttpClient client, string node, string upid) - { - var encodedUpid = Uri.EscapeDataString(upid); - var statusResource = $"nodes/{node}/tasks/{encodedUpid}/status"; - - while (true) - { - System.Threading.Thread.Sleep(2000); - var statusJson = client.GetAsync(statusResource).GetAwaiter().GetResult(); - var statusRoot = JObject.Parse(statusJson); - var data = statusRoot["data"]; - var status = data?["status"]?.ToString(); - var exitStatus = data?["exitstatus"]?.ToString(); - - if (status == "stopped") - { - return new PveTask - { - Upid = upid, - Node = node, - Status = status, - ExitStatus = exitStatus - }; - } - } - } } /// Validates that a file path exists on disk. diff --git a/src/PSProxmoxVE/Cmdlets/Tasks/WaitPveTaskCmdlet.cs b/src/PSProxmoxVE/Cmdlets/Tasks/WaitPveTaskCmdlet.cs index f29b2cb..6de8c12 100644 --- a/src/PSProxmoxVE/Cmdlets/Tasks/WaitPveTaskCmdlet.cs +++ b/src/PSProxmoxVE/Cmdlets/Tasks/WaitPveTaskCmdlet.cs @@ -53,7 +53,7 @@ namespace PSProxmoxVE.Cmdlets.Tasks var deadline = Timeout.HasValue ? DateTime.UtcNow + Timeout.Value : DateTime.MaxValue; var encodedUpid = Uri.EscapeDataString(Upid); - var statusResource = $"nodes/{Node}/tasks/{encodedUpid}/status"; + var statusResource = $"nodes/{Uri.EscapeDataString(Node)}/tasks/{encodedUpid}/status"; // Derive a short human-readable description from the UPID for progress display var taskDesc = Upid.Length > 50 ? Upid.Substring(0, 47) + "..." : Upid; diff --git a/src/PSProxmoxVE/PSProxmoxVE.csproj b/src/PSProxmoxVE/PSProxmoxVE.csproj index 84247a7..84e8ae5 100644 --- a/src/PSProxmoxVE/PSProxmoxVE.csproj +++ b/src/PSProxmoxVE/PSProxmoxVE.csproj @@ -1,7 +1,7 @@ - netstandard2.0;net9.0;net48 + netstandard2.0;net10.0;net48 10.0 enable PSProxmoxVE @@ -18,8 +18,8 @@ - - + + diff --git a/tests/PSProxmoxVE.Tests/_TestHelper.ps1 b/tests/PSProxmoxVE.Tests/_TestHelper.ps1 index af43701..8d7b722 100644 --- a/tests/PSProxmoxVE.Tests/_TestHelper.ps1 +++ b/tests/PSProxmoxVE.Tests/_TestHelper.ps1 @@ -30,10 +30,10 @@ $repoRoot = Resolve-Path (Join-Path $PSScriptRoot '../..') $moduleRoot = Join-Path $repoRoot 'src/PSProxmoxVE' if ($PSVersionTable.PSEdition -eq 'Core') { - $frameworks = @('netstandard2.0', 'net9.0', 'net48') + $frameworks = @('netstandard2.0', 'net10.0', 'net48') } else { - $frameworks = @('net48', 'netstandard2.0', 'net9.0') + $frameworks = @('net48', 'netstandard2.0', 'net10.0') } $searchPaths = foreach ($fw in $frameworks) {