Remove-DataGatewayClusterUser
Removes users (including admins) from a gateway cluster
Sintaxe
Default (Padrão)
Remove-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
[-RegionKey <String>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[<CommonParameters>]
Description
Removes users (including admins) from a gateway cluster
Exemplos
Example 1
PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove
Removes user "testUpn@tenant.com" from the gateway cluster.
Example 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
Removes the user "testUpn@tenant.com" from the gateway cluster. This command is run in the Brazil south region, so the gateway cluster ID provided should be in that region.
Parâmetros
-GatewayClusterId
Gateway cluster where the user needs to be removed
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Cluster, Id |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrincipalObjectId
Azure Active Directory (AAD) principal object ID (i.e. user ID) of the user to be removed
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | User |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RegionKey
The region in which this command has to run in. Not providing a -RegionKey will run the command in the default region for your tenant.
To get the list of available region parameters run the Get-DataGatewayRegion command
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Scope
Security Scope to run the command. This would determine if you are running this command in the scope of a Tenant/Service admin or a Gateway Admin
Propriedades do parâmetro
| Tipo: | PowerBIUserScope |
| Valor padrão: | Individual |
| Valores aceitos: | Individual, Organization |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.