Remove-DataGatewayClusterUser
Entfernt Benutzer (einschließlich Administratoren) aus einem Gatewaycluster.
Syntax
Default (Standardwert)
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üden" ausgeführt, sodass sich die bereitgestellte Gatewaycluster-ID in dieser Region befinden sollte.
Parameter
-GatewayClusterId
Gatewaycluster, in dem der Benutzer entfernt werden muss
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Kluster, Id |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PrincipalObjectId
Azure Active Directory (AAD)-Prinzipalobjekt-ID (d. h. Benutzer-ID) des zu entfernenden Benutzers
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Benutzer |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Sicherheitsbereich, um den Befehl auszuführen. Dies würde bestimmen, ob Sie diesen Befehl im Bereich eines Mandanten-/Dienstadministrators oder eines Gatewayadministrators ausführen.
Parametereigenschaften
| Typ: | PowerBIUserScope |
| Standardwert: | Individual |
| Zulässige Werte: | Individual, Organization |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.