FabricTools v0.33.0 Public Preview

Get-FabricWorkspaceUser

Retrieves the user(s) of a workspace.

Syntax

Parameter set: WorkspaceId
Get-FabricWorkspaceUser -WorkspaceId <guid> [<CommonParameters>]
Parameter set: WorkspaceObject
Get-FabricWorkspaceUser -Workspace <Object[]> [<CommonParameters>]

Description

The Get-FabricWorkspaceUser function retrieves the details of the users of a workspace. Each returned user includes the workspace name and ID for context.

Examples

Example 1

This example retrieves the users of a workspace of the workspace with the ID '12345678-1234-1234-1234-123456789012'.

Get-FabricWorkspaceUser -WorkspaceId '12345678-1234-1234-1234-123456789012

Example 2

This example retrieves the users of the prod-workspace workspace by piping the object.

$workspace = Get-FabricWorkspace -WorkspaceName 'prod-workspace'

$workspace | Get-FabricWorkspaceUser

Example 3

This example retrieves the users of the prod-workspace workspace by piping the object.

Get-FabricWorkspaceUser -Workspace (Get-FabricWorkspace -WorkspaceName 'prod-workspace')

Example 4

This example retrieves the users of all of the workspaces, including each user's workspace name and ID.

Get-FabricWorkspace| Get-FabricWorkspaceUser

Parameters

NameTypeReq.Pos.PipelineDescription
-Workspace object[] ✓Required Named Value

The workspace object. This normally comes from the Get-FabricWorkspace cmdlet. This is a mandatory parameter if WorkspaceId is not provided.

-WorkspaceIdalias: Id guid ✓Required Named –

The ID of the workspace. This is a mandatory parameter if Workspace is not provided.

This cmdlet also supports the common parameters, such as -Verbose and -ErrorAction. See about_CommonParameters.

Inputs

System.Object[]

{{ Fill in the Description }}

Notes

It supports multiple aliases for backward compatibility. The function defines parameters for the workspace ID and workspace object. If the parameter set name is 'WorkspaceId', it retrieves the workspace object. It then makes a GET request to the PowerBI API to retrieve the users of the workspace and returns the 'value' property of the response, which contains the users.

Author: Ioana Bouariu