Remove-DataGatewayClusterUser

Referenz

Modul:: DataGateway

Entfernt Benutzer (einschließlich Administratoren) aus einem Gatewaycluster.

Syntax

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

Beschreibung

Entfernt Benutzer (einschließlich Administratoren) aus einem Gatewaycluster.

Beispiele

Beispiel 1

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

Entfernt den Benutzer "testUpn@tenant.com" aus dem Gatewaycluster.

Beispiel 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

Entfernt den Benutzer "testUpn@tenant.com" aus dem Gatewaycluster. Dieser Befehl wird in der Region Brasilien süd ausgeführt, sodass die bereitgestellte Gatewaycluster-ID in dieser Region enthalten sein sollte.

Parameter

-GatewayClusterId

Gatewaycluster, in dem der Benutzer entfernt werden muss

Typ:	Guid
Aliase:	Cluster, Id
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PrincipalObjectId

Azure Active Directory (AAD)-Prinzipalobjekt-ID (d. h. Benutzer-ID) des zu entfernenden Benutzers

Typ:	Guid
Aliase:	User
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RegionKey

Der Bereich, in dem dieser Befehl ausgeführt werden muss. Wenn Sie keine -RegionKey bereitstellen, wird der Befehl in der Standardregion für Ihren Mandanten ausgeführt. Führen Sie den Befehl Get-DataGatewayRegion aus, um die Liste der verfügbaren Regionsparameter abzurufen

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Sicherheitsbereich zum Ausführen des Befehls. Dies würde bestimmen, ob Sie diesen Befehl im Bereich eines Mandanten-/Dienstadministrators oder eines Gatewayadministrators ausführen.

Typ:	PowerBIUserScope
Zulässige Werte:	Individual, Organization
Position:	Named
Standardwert:	Individual
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Ausgaben

System.Void

Freigeben über