https://github.com/dataplat/fabrictools
FabricTools is a free, open-source, community-driven PowerShell module designed to facilitate the management of Microsoft Fabric workspaces and capacities.
https://github.com/dataplat/fabrictools
Last synced: about 1 year ago
JSON representation
FabricTools is a free, open-source, community-driven PowerShell module designed to facilitate the management of Microsoft Fabric workspaces and capacities.
- Host: GitHub
- URL: https://github.com/dataplat/fabrictools
- Owner: dataplat
- License: mit
- Created: 2025-02-20T18:38:53.000Z (over 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-06-10T08:54:59.000Z (about 1 year ago)
- Last Synced: 2025-06-10T09:32:59.034Z (about 1 year ago)
- Language: PowerShell
- Homepage:
- Size: 2.95 MB
- Stars: 30
- Watchers: 9
- Forks: 5
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# FabricTools PowerShell Module
[](https://www.powershellgallery.com/packages/FabricTools)
**FabricTools** is a PowerShell module to able to do more with Microsoft Fabric and Power BI.
It allows for various administrative tasks to be automated and integrated into workflows.
We are at an early stage of development and the module is in its **Public PREVIEW**.
Do NOT use it with Production environments.
## Features
- Manage Microsoft Fabric workspaces and datasets.
- Assign Microsoft Fabric workspaces to capacities.
- Retrieve and manipulate Microsoft Fabric tenant settings.
- Handle Microsoft Fabric access tokens for authentication.
- Suspend and resume Microsoft Fabric capacities.
- Fabric-friendly aliases for lots of the old PowerBI cmdlets
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
### Prerequisites
- PowerShell 5.1 or higher
- Access to PowerBI service and Azure subscription (for certain functions)
- Necessary permissions to manage PowerBI workspaces and Fabric capacities
- The following PowerShell modules: MicrosoftPowerBIMgmt, Az.Accounts, Az.Resources
### Installing
To install the FabricTools module, you can install it from the PowerShell Gallery:
```powershell
Install-Module FabricTools
```
Or clone the repository to your local machine and import the module:
```powershell
# Clone the repository
git clone https://github.com/dataplat/FabricTools.git
# Import the module
Import-Module ./FabricTools/FabricTools.psm1
```
## Usage
Once imported, you can call any of the functions provided by the module. For example:
```powershell
# Assign a workspace to a capacity
Register-FabricWorkspaceToCapacity -WorkspaceId "Workspace-GUID" -CapacityId "Capacity-GUID"
```
Refer to the individual function documentation for detailed usage instructions.
Every now and again the authentication token might time out. Run this to get a new one:
```powershell
Update-FabricToken
```
If you want to change user context run this:
```powershell
Connect-FabricAccount
```
## Release Notes
The entire history of changes to this module can be find here: [Release Notes](ReleaseNotes.md)
## Code of Conduct
This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to the project team.
## Contributing
Contributions to FabricTools are welcome.
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to develop, test and the process for submitting pull requests to us.
## Authors
_(in alphabetical order)_
- **Tiago Balabuch** - *Huge contribution (90% functions)* - [tiagobalabuch](https://github.com/tiagobalabuch)
- **Ioana Bouariu** - *Initial work* - [Jojobit](https://github.com/Jojobit)
- **Frank Geisler** - *Author of RTI functions* - [Frank Geisler](https://github.com/Frank-Geisler)
- **Kamil Nowinski** - *Refactoring, unification, further commands* - [NowinskiK](https://github.com/NowinskiK)
- **Jess Pomfret** - *Automation, great experience with PowerShell* - [jpomfret](https://github.com/jpomfret)
- **Rob Sewell** - *Automation/DevOps, Governance and experience brought from dbatools* - [SQLDBAWithABeard](https://github.com/SQLDBAWithABeard)
See also the list of [contributors](https://github.com/dataplat/FabricTools/contributors) who participated in this project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- GitHub Copilot and ChatGPT for helping with the documentation
- [**Rui Romano**](https://github.com/RuiRomano) - His work on a [Fabric PowerShell module](https://github.com/microsoft/Analysis-Services/tree/master/pbidevmode/fabricps-pbip) has been included into this module with his permission. Thanks, Rui!
- [**Tiago Balabuch**](https://github.com/tiagobalabuch) and his phenomenal huge work that make this module more robust and very well organised.