Add-RoleMember

Referenz

Modul:: SQLServer

Fügt einem bestimmten Element eine bestimmte Rolle einer bestimmten Datenbank hinzu.

Syntax

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>]

Beschreibung

Das Cmdlet Add-RoleMember fügt abhängig von den Eingabewerten ein gültiges Element zu einer bestimmten Rolle einer bestimmten Datenbank hinzu.

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

Beispiele

Beispiel 1: Hinzufügen von Mitglied zur Rolle mithilfe der 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"

Mit diesem Befehl wird der ersten Rolle einer bestimmten Datenbank ein Mitglied hinzugefügt.

Beispiel 2: Hinzufügen von Mitglied zur Rolle mithilfe der Pipeline in 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]

Fügen Sie ein Mitglied zur ersten Rolle einer bestimmten Datenbank hinzu, indem Sie benannte Parameter für eine tabellarische Datenbank mit Kompatibilitätsebene 1200 oder höher verwenden.

Beispiel 3: Hinzufügen eines Mitglieds zur Rolle mithilfe des Namens

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

Hinzufügen eines Mitglieds zur Datenbankrolle mithilfe des Rollennamens

Parameter

-ApplicationId

Die Anwendungs-ID für den Dienstprinzipal.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CertificateThumbprint

Der Zertifikatfingerabdruck für den Dienstprinzipal.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Wenn dieser Parameter angegeben ist, wird der übergebene Benutzername und das Kennwort verwendet, um eine Verbindung mit der angegebenen Analysis Server-Instanz herzustellen. Wenn keine Anmeldeinformationen für das Standardfensterkonto des Benutzers angegeben werden, der das Tool ausführt, wird verwendet.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Database

Datenbankname, zu dem die Rolle gehört.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DatabaseRole

Der Microsoft.AnalysisServices.Role, dem ein Mitglied hinzugefügt werden soll. Dies gilt nicht für tabellarische Datenbanken mit Kompatibilitätsebene 1200 oder höher.

Typ:	Role
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-MemberName

Der Name des Mitglieds, der der Rolle hinzugefügt werden soll.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ModelRole

Die Modellrolle, der das Mitglied hinzugefügt werden soll.

Typ:	ModelRole
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:	ActionPreference
Aliase:	proga
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleName

Name der Rolle, der das Mitglied hinzugefügt werden soll.

Typ:	String
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Server

Gibt optional die Serverinstanz an, mit der eine Verbindung hergestellt werden soll, wenn sie sich derzeit nicht im SQLAS-Anbieterverzeichnis befindet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServicePrincipal

Gibt an, dass diese Verbindung den Dienstprinzipal verwendet.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TenantId

Die Mandanten-ID für den Dienstprinzipal.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

Ausgaben

System.Object

None

Hinweise

Unterstützt für alle Analysis Services-Instanzen, die derzeit vom PowerBI Premium-Produkt nicht unterstützt werden. Sie wird in Zukunft unterstützt.

Freigeben über