Remove-DataGatewayClusterUser
Remove usuários (incluindo administradores) de um cluster de gateway
Sintaxe
Default (Padrão)
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
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Clúster, 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
ID do objeto principal do Azure Active Directory (AAD) (ou seja, ID de usuário) do usuário a ser removido
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Utilizador |
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
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
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
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
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
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.