Add-RoleMember cmdlet

项目
06/11/2013

将成员添加到 Analysis Services 表格或多维数据库的指定角色。

语法

Add-RoleMember [-MemberName] <System.String> [-Database] <System.String> [-RoleName] <System.String> [<CommonParameters>]

Add-RoleMember [-MemberName] <System.String> [-DatabaseRole] <Microsoft.AnalysisServices.Role> [<CommonParameters>]

说明

Add-RoleMember cmdlet 将有效成员添加到现有数据库角色。仅允许数据库角色。不能使用此 cmdlet 向服务器角色添加成员。

一次只能添加一个成员，该成员可以是用户或组帐户。

参数

-MemberName <string>

指定要添加到该角色的 Windows 用户或组。

必需？	true
位置？	0
默认值
接受管道输入？	false
接受通配符？	false

-Database <string>

指定角色属于的数据库。

必需？	true
位置？	1
默认值
接受管道输入？	false
接受通配符？	false

-RoleName <string>

指定要将成员添加到的角色。

必需？	true
位置？	2
默认值
接受管道输入？	false
接受通配符？	false

-DatabaseRole <string>

指定成员应该添加到的 Microsoft.AnalysisServices.Role 对象。在您想要通过管道来提供数据库角色时，可以使用此参数来代替–Database 和 –RoleName 参数。

必需？	true
位置？	所指定位置
默认值
接受管道输入？	true (ByPropertyName)
接受通配符？	false

<CommonParameters>

此 cmdlet 支持以下常用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 About_CommonParameters。

输入和输出

输入类型是可以传送到 cmdlet 的对象的类型。返回类型是 cmdlet 所返回的对象的类型。

输入	无。
输出	无

示例 1

PS SQLSERVER:\sqlas\localhost\default> add-rolemember –membername “adventure-works\bobh” –database “AdventureWorks” –rolename “Reader”

对于正在本地默认实例上运行的 AdventureWorks 数据库，此命令将一个 Windows 域用户帐户添加到 Reader 角色。

示例 2

PS SQLSERVER:\sqlas\localhost\default> $roles= dir .\databases\AWTEST\Roles
PS SQLSERVER:\sqlas\localhost\default> $roles
PS SQLSERVER:\sqlas\localhost\default> add-rolemember –membername:“adventure-works\bobh” –databaserole:$roles[0]

第 1 行将 AWTEST 数据库的所有数据库角色添加到管道。第 2 行（您在提示符处键入 $roles）显示角色数组。第 3 行将 Windows 用户 adventure-works\bobh 作为第一个角色的成员添加到该数组中。

示例 3

PS SQLSERVER:\sqlas\localhost\default\Databases\AWTEST\Roles> $roles=dir
PS SQLSERVER:\sqlas\localhost\default\Databases\AWTEST\Roles> $roles[0] | Add-rolemember –membername “adventure-works\bobh”

此命令将一个 Windows 域用户帐户添加到某一数组中的第一个角色上，该数组是通过列出特定数据库 (AWTEST) 的上下文中 Roles 文件夹的子级创建的。

通过