Skip to content

New-PBIWorkspace

SYNOPSIS

Create a new workspace in the Power BI service.

SYNTAX

New-PBIWorkspace [-WorkspaceName] <String[]> [-CRMWorkspace] [-taskNumber] <Int32> [<CommonParameters>]

DESCRIPTION

This function creates a new workspace in the Power BI service with the following: - Two mail-enabled local AD groups for permissions, synced to Azure Active Directory. - Administrative rights assigned to the `L_ADM_BI_Administrators` group. - A mandatory Digipolis group added as an admin group. Authentication is performed using Azure Service Principals, requiring appropriate permissions in PasswordState.

EXAMPLES

EXAMPLE 1

New-PBIWorkspace -WorkspaceName "Finance" -TaskNumber 12345

Creates a new Power BI workspace named "Finance" and assigns the appropriate permissions.

EXAMPLE 2

New-PBIWorkspace -WorkspaceName "CRM Sales" -CRMWorkspace -TaskNumber 67890

Creates a new CRM-specific Power BI workspace named "CRM Sales" and assigns CRM-specific admin groups.

PARAMETERS

-WorkspaceName

The name(s) of the workspace(s) to be created.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-CRMWorkspace

A switch to indicate if the workspace is a CRM workspace. If enabled, specific admin groups are assigned.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-taskNumber

The task number associated with the creation of the workspace, used for logging purposes.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: 0
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.

INPUTS

OUTPUTS

NOTES