Remove-DataGatewayClusterUser

Referência

Módulo:: DataGateway

Remove usuários (incluindo administradores) de um cluster de gateway

Sintaxe

Remove-DataGatewayClusterUser
      [-Scope <PowerBIUserScope>]
      [-RegionKey <String>]
      -GatewayClusterId <Guid>
      -PrincipalObjectId <Guid>
      [<CommonParameters>]

Description

Remove usuários (incluindo administradores) de um cluster de gateway

Exemplos

Exemplo 1

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove

Remove o usuário "testUpn@tenant.com" do cluster do gateway.

Exemplo 2

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove -RegionKey brazilsouth

Remove o usuário "testUpn@tenant.com" do cluster do gateway. Esse comando é executado na região sul do Brasil, portanto, a ID do cluster de gateway fornecida deve estar nessa região.

Parâmetros

-GatewayClusterId

Cluster de gateway em que o usuário precisa ser removido

Tipo:	Guid
Aliases:	Cluster, Id
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PrincipalObjectId

ID do objeto principal do Azure Active Directory (AAD) (ou seja, ID de usuário) do usuário a ser removido

Tipo:	Guid
Aliases:	User
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RegionKey

A região na qual esse comando precisa ser executado. Não fornecer um -RegionKey executará o comando na região padrão do locatário. Para obter a lista de parâmetros de região disponíveis, execute o comando Get-DataGatewayRegion

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Scope

Escopo de Segurança para executar o comando. Isso determinaria se você está executando esse comando no escopo de um administrador de Locatário/Serviço ou de um Administrador de Gateway

Tipo:	PowerBIUserScope
Valores aceitos:	Individual, Organization
Cargo:	Named
Valor padrão:	Individual
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

System.Void

Compartilhar via