FabricTools

KO | EN

gitlite — search

#javascript #python #ruby #php #hacktoberfest #library #dotfiles #shell #c-plus-plus #bash #metadata #java

★ 58 Open GitHub ↗

FabricTools is a free, open-source, community-driven PowerShell module designed to facilitate the management of Microsoft Fabric workspaces and capacities.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FabricTools PowerShell Module

[![PowerShell Gallery Version](https://img.shields.io/powershellgallery/v/FabricTools?label=PowerShell%20Gallery&color=blue)](https://www.powershellgallery.com/packages/FabricTools)
![PowerShell Gallery Downloads](https://img.shields.io/powershellgallery/dt/FabricTools?label=PSGallery%20downloads)

**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.
<br/>
<br/>

## 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.

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=dataplat/FabricTools&type=date&legend=top-left)](https://www.star-history.com/#dataplat/FabricTools&type=date&legend=top-left)

## 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.

FabricTools

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README