Add-RoleMember

參考

模組:: SQLServer

將成員加入至特定資料庫的特定角色。

語法

Add-RoleMember
   [-MemberName] <String>
   [-Database] <String>
   [-RoleName] <String>
   [-Server <String>]
   [-Credential <PSCredential>]
   [-ServicePrincipal]
   [-ApplicationId <String>]
   [-TenantId <String>]
   [-CertificateThumbprint <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-RoleMember
   [-MemberName] <String>
   -DatabaseRole <Role>
   [-Server <String>]
   [-Credential <PSCredential>]
   [-ServicePrincipal]
   [-ApplicationId <String>]
   [-TenantId <String>]
   [-CertificateThumbprint <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-RoleMember
   [-MemberName] <String>
   -ModelRole <ModelRole>
   [-Server <String>]
   [-Credential <PSCredential>]
   [-ServicePrincipal]
   [-ApplicationId <String>]
   [-TenantId <String>]
   [-CertificateThumbprint <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-RoleMember
   [-Server <String>]
   [-Credential <PSCredential>]
   [-ServicePrincipal]
   [-ApplicationId <String>]
   [-TenantId <String>]
   [-CertificateThumbprint <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add-RoleMember Cmdlet 會根據輸入值，將有效的成員新增至特定資料庫的特定角色。

Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.

範例

範例 1：使用管線將成員新增至角色

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"

此命令會將成員新增至指定資料庫的第一個角色。

範例 2：在表格式 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]

針對相容性層級為 1200 或更高版本的表格式資料庫，使用具名參數，將成員新增至指定資料庫的第一個角色。

範例 3：使用名稱將成員新增至角色

PS C:\> Add-RoleMember -MemberName "foo\user1" -Database "DB1" -RoleName "myRole"

使用角色名稱將成員新增至資料庫角色

參數

-ApplicationId

服務主體的應用程式識別碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificateThumbprint

服務主體的憑證指紋。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Credential

如果指定此參數，傳遞的使用者名稱和密碼將用來連線到指定的 Analysis Server 實例。如果未指定任何認證，則會使用執行此工具之用戶的預設 Windows 帳戶。

類型:	PSCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Database

角色所屬的資料庫名稱。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DatabaseRole

要加入成員的 Microsoft.AnalysisServices.Role。這不適用於相容性層級為1200或更高版本的表格式資料庫。

類型:	Role
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-MemberName

應該新增至角色的成員名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ModelRole

要加入成員的模型角色。

類型:	ModelRole
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ProgressAction

決定 PowerShell 如何回應腳本、Cmdlet 或提供者所產生的進度更新，例如 Write-Progress Cmdlet 所產生的進度列。 Write-Progress Cmdlet 會建立顯示命令狀態的進度列。

類型:	ActionPreference
別名:	proga
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RoleName

應該加入成員的角色名稱。

類型:	String
Position:	2
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Server

選擇性地指定要連接到的伺服器實例，如果目前不在 SQLAS 提供者目錄中。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServicePrincipal

指定此連線使用服務主體。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TenantId

服務主體的租用戶標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

輸出

System.Object

None

備註

PowerBI Premium 產品目前不支援的所有 Analysis Services 實例支援。未來將受到支援。

共用方式為