Add-RoleMember
Agrega un miembro a un rol específico de una base de datos concreta.
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
El cmdlet Add-RoleMember agrega un miembro válido a un rol específico de una base de datos concreta según los valores de entrada.
Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.
Ejemplos
Ejemplo 1: Adición de un miembro al rol mediante la canalización
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"Este comando agrega un miembro al primer rol de una base de datos determinada.
Ejemplo 2: Agregar miembro al rol mediante la canalización en 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]Agregue un miembro al primer rol de una base de datos determinada mediante parámetros con nombre para una base de datos tabular con el nivel de compatibilidad 1200 o superior.
Ejemplo 3: Agregar miembro al rol mediante el nombre
PS C:\> Add-RoleMember -MemberName "foo\user1" -Database "DB1" -RoleName "myRole"Agregar un miembro al rol de base de datos con el nombre del rol
Parámetros
-ApplicationId
Identificador de aplicación de la entidad de servicio.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateThumbprint
Huella digital del certificado para la entidad de servicio.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Si se especifica este parámetro, el nombre de usuario y la contraseña pasadas se utilizarán para conectarse a la instancia de Analysis Server especificada. Si no se especifica ninguna credencial, se utilizará la cuenta predeterminada de Windows del usuario que ejecuta la herramienta.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Database
Nombre de la base de datos a la que el rol pertenece.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseRole
Microsoft.AnalysisServices.Role al que se va a agregar un miembro. Esto no es aplicable a las bases de datos tabulares con el nivel de compatibilidad 1200 o superior.
| Type: | Role |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MemberName
Nombre del miembro que debería agregarse al rol.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModelRole
Rol de modelo al que se va a agregar el miembro.
| Type: | ModelRole |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RoleName
Nombre del rol al que el miembro debería agregarse.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Opcionalmente, especifica la instancia del servidor a la que conectarse si no está actualmente en el directorio del proveedor de SQLAS.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServicePrincipal
Especifica que esta conexión usa la entidad de servicio.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
Identificador de inquilino de la entidad de servicio.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| 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
Salidas
System.Object
None
Notas
Compatible con todas las instancias de Analysis Services Actualmente no admitidas por el producto PowerBI Premium. Se admitirá en el futuro.