> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/vi/tich-hop-va-api/powershell-module.md).

# Mô-đun PowerShell của VergeOS (PSVergeOS)

## Tổng quan

PSVergeOS là một mô-đun PowerShell để quản lý hạ tầng VergeOS thông qua REST API. Nó cung cấp hơn 200 cmdlet để tự động hóa vòng đời VM, mạng, lưu trữ, các thao tác đa thuê bao và quy trình khôi phục sau thảm họa, cho phép quản trị viên tận dụng chuyên môn PowerShell của họ để quản lý VergeOS.

## Tính năng chính

* **Quản lý VM**: Tạo, cấu hình, điều khiển nguồn, sao chép, ảnh chụp nhanh và di chuyển
* **Mạng nâng cao**: Mạng ảo, quy tắc tường lửa, DHCP, DNS, VPN IPSec và WireGuard
* **NAS & Lưu trữ**: Quản lý volume, chia sẻ CIFS/NFS và đồng bộ hóa
* **Đa thuê bao**: Cấp phát tenant với cách ly tài nguyên
* **Khôi phục sau thảm họa**: Ảnh chụp nhanh trên đám mây, đồng bộ hóa site, quy trình khôi phục
* **Hỗ trợ pipeline**: Các cmdlet có thể xâu chuỗi cho các thao tác hàng loạt
* **Đa nền tảng**: Windows, macOS và Linux với PowerShell 7.4+

## Yêu cầu

* PowerShell 7.4 hoặc mới hơn
* VergeOS 26.0 trở lên

## Cài đặt

### Từ PowerShell Gallery (Khuyến nghị)

```powershell
Install-Module -Name PSVergeOS -Scope CurrentUser
```

### Cài đặt thủ công

```powershell
git clone https://github.com/verge-io/PSVergeOS.git
Import-Module ./PSVergeOS/PSVergeOS.psd1
```

## Xác thực

Mô-đun hỗ trợ nhiều phương thức xác thực:

* **Thông tin xác thực tương tác**: Nhắc nhập tên người dùng và mật khẩu tại thời gian chạy
* **Đối tượng PSCredential**: Tự động hóa xác thực bằng thông tin xác thực đã lưu
* **Mã thông báo API**: Sử dụng các mã thông báo được tạo sẵn cho các kịch bản không tương tác
* **Chứng chỉ tự ký**: Tùy chọn bỏ qua xác thực chứng chỉ cho môi trường thử nghiệm

## Các cmdlet có sẵn

Mô-đun chứa hơn 200 cmdlet được tổ chức theo danh mục:

| Danh mục          | Mô tả                                                          |
| ----------------- | -------------------------------------------------------------- |
| Kết nối           | Kết nối, ngắt kết nối và quản lý các kết nối máy chủ           |
| Máy ảo            | Vòng đời, ảnh chụp nhanh, ổ đĩa, NIC                           |
| Mạng              | Mạng, quy tắc, DNS, DHCP, chẩn đoán                            |
| VPN               | Kết nối/chính sách IPSec, giao diện/người ngang hàng WireGuard |
| NAS/Lưu trữ       | Dịch vụ, volume, chia sẻ, ảnh chụp nhanh, đồng bộ hóa          |
| Tenant            | Cấp phát, ảnh chụp nhanh, phân bổ lưu trữ                      |
| Người dùng & Nhóm | Quản lý tài khoản, quyền, khóa API                             |
| Hệ thống          | Cụm, nút, giấy phép, cài đặt                                   |
| Giám sát          | Cảnh báo, nhật ký, tác vụ                                      |
| Sao lưu & DR      | Hồ sơ, ảnh chụp nhanh trên đám mây, quản lý site               |

## Các trường hợp sử dụng phổ biến

* **Thao tác VM hàng loạt**: Dừng, khởi động, chụp ảnh nhanh hoặc di chuyển nhiều VM với hỗ trợ pipeline
* **Báo cáo hạ tầng**: Xuất danh mục VM, mức sử dụng tài nguyên và dữ liệu cấu hình
* **Tự động hóa mạng**: Tạo mạng, cấu hình DHCP và quản lý quy tắc tường lửa
* **Bảo trì theo lịch**: Tích hợp với Task Scheduler hoặc cron cho các thao tác tự động
* **Tích hợp CI/CD**: Cấp phát môi trường thử nghiệm như một phần của các pipeline triển khai

Để xem các mẫu mã, hãy xem [thư mục Examples](https://github.com/verge-io/PSVergeOS/tree/main/Examples) trong kho lưu trữ GitHub.

## Tài liệu và tài nguyên

Để xem tài liệu đầy đủ, bao gồm tất cả các cmdlet, tham số và ví dụ sử dụng chi tiết, hãy truy cập kho lưu trữ chính thức:

* [Kho lưu trữ GitHub](https://github.com/verge-io/PSVergeOS)
* [PowerShell Gallery](https://www.powershellgallery.com/packages/PSVergeOS)

## Hỗ trợ

Nếu bạn gặp sự cố hoặc có yêu cầu tính năng, vui lòng mở một issue trên kho lưu trữ GitHub:

<https://github.com/verge-io/PSVergeOS/issues>

## Tài nguyên bổ sung

* [Tài liệu PowerShell](https://learn.microsoft.com/en-us/powershell/)
* [Tài liệu API VergeOS](/knowledge-base/vi/automation-api/verge-api-guide.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/automate-protect-and-extend/vi/tich-hop-va-api/powershell-module.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.