Add-RoleMember
Adiciona um membro a uma Função específica de um banco de dados específico.
Syntax
Add-RoleMember
[-MemberName] <String>
[-Database] <String>
[-RoleName] <String>
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-RoleMember
[-MemberName] <String>
-DatabaseRole <Role>
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-RoleMember
[-MemberName] <String>
-ModelRole <ModelRole>
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-RoleMember
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Add-RoleMember adiciona um membro válido a uma Função específica de um banco de dados específico dependendo dos valores de entrada.
Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.
Exemplos
Exemplo 1: Adicionar membro à função usando pipeline
PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles\> $roles = Get-Children
PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles\> $roles[0] | Add-RoleMember -MemberName "memberName"
Esse comando adiciona um membro à primeira função de um determinado banco de dados.
Exemplo 2: Adicionar membro à função usando pipeline no Tabular 1200
PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles\> $roles = Get-Children
PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles\> Add-RoleMember -MemberName "memberName" -ModelRole $roles[0]
Adicione um membro à primeira função de um determinado banco de dados usando parâmetros nomeados para um banco de dados tabular com nível de compatibilidade 1200 ou superior.
Exemplo 3: Adicionar membro à função usando o nome
PS C:\> Add-RoleMember -MemberName "foo\user1" -Database "DB1" -RoleName "myRole"
Adicionar um membro à função de banco de dados usando o nome da função
Parâmetros
-ApplicationId
A ID do aplicativo para a entidade de serviço.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
A impressão digital do certificado para a entidade de serviço.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Se este parâmetro for especificado, o nome de usuário e a senha serão passados para conectar à instância do Analysis Server especificado. Se nenhuma credencial for especificada, será usada a conta do Windows padrão do usuário que está executando a ferramenta.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
Nome do banco de dados ao qual a Função pertence.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseRole
O Microsoft.AnalysisServices.Role ao qual adicionar um membro. Isso não se aplica a bancos de dados tabulares com nível de compatibilidade 1200 ou superior.
Type: | Role |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MemberName
O nome do membro que deve ser adicionado à função.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModelRole
A função de modelo à qual adicionar o membro.
Type: | ModelRole |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleName
O nome da função à qual o membro deve ser adicionado.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Server
Opcionalmente, especifica a instância do servidor à qual se conectar se não estiver atualmente no diretório Provedor do SQLAS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicePrincipal
Especifica que essa conexão está usando a entidade de serviço.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantId
A ID do locatário da entidade de serviço.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.AnalysisServices.Role
Microsoft.AnalysisServices.Tabular.ModelRole
Saídas
System.Object
None
Observações
Com suporte em todas as instâncias do Analysis Services Atualmente sem suporte pelo produto PowerBI Premium. Ele terá suporte no futuro.