Remove-DataGatewayClusterUser

Riferimento

Modulo:: DataGateway

Rimuove gli utenti (inclusi gli amministratori) da un cluster gateway

Sintassi

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

Descrizione

Rimuove gli utenti (inclusi gli amministratori) da un cluster gateway

Esempio

Esempio 1

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

Rimuove l'utente "testUpn@tenant.com" dal cluster del gateway.

Esempio 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

Rimuove l'utente "testUpn@tenant.com" dal cluster del gateway. Questo comando viene eseguito nell'area sud del Brasile, quindi l'ID cluster del gateway specificato deve trovarsi in tale area.

Parametri

-GatewayClusterId

Cluster del gateway in cui l'utente deve essere rimosso

Tipo:	Guid
Alias:	Cluster, Id
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PrincipalObjectId

ID oggetto dell'entità di sicurezza di Azure Active Directory (ad esempio ID utente) dell'utente da rimuovere

Tipo:	Guid
Alias:	User
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RegionKey

Area in cui deve essere eseguito questo comando. Se non si specifica un -RegionKey, il comando verrà eseguito nell'area predefinita per il tenant. Per ottenere l'elenco dei parametri di area disponibili, eseguire il comando Get-DataGatewayRegion

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Scope

Ambito di sicurezza per eseguire il comando. Ciò determina se si esegue questo comando nell'ambito di un amministratore tenant/servizio o di un amministratore del gateway

Tipo:	PowerBIUserScope
Valori accettati:	Individual, Organization
Posizione:	Named
Valore predefinito:	Individual
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

None

Output

System.Void

Condividi tramite