Add-RoleMember

Referenz

Modul:: SQLServer

Fügt einer bestimmten Rolle einer angegebenen Datenbank ein Mitglied hinzu.

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

Beschreibung

Das Add-RoleMember-Cmdlet fügt einer bestimmten Rolle einer angegebenen Datenbank abhängig von den Eingabewerten ein gültiges Mitglied 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 eines Mitglieds 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 Member hinzugefügt.

Beispiel 2: Hinzufügen eines Mitglieds zur Rolle mithilfe der Pipeline in Tabellarisch 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 der ersten Rolle einer bestimmten Datenbank ein Mitglied mit benannten Parametern für eine tabellarische Datenbank mit Kompatibilitätsgrad 1200 oder höher hinzu.

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Der Zertifikatfingerabdruck für den Dienstprinzipal.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Wenn dieser Parameter angegeben wird, werden der übergebene Benutzername bzw. das übergebene Kennwort verwendet, um eine Verbindung mit der angegebenen Analysis-Server-Instanz herzustellen. Wenn keine Anmeldeinformationen angegeben sind, wird das Standard-Windows-Konto des Benutzers, der das Tool ausführt, verwendet.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Der Name der Datenbank, der die Rolle angehört.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseRole

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

Type:	Role
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MemberName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ModelRole

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

Type:	ModelRole
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RoleName

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

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

Gibt optional den Server instance an, mit dem eine Verbindung hergestellt werden soll, wenn sich dies derzeit nicht im SQLAS-Anbieterverzeichnis befindet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Gibt an, dass diese Verbindung den Dienstprinzipal verwendet.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

Die Mandanten-ID für den Dienstprinzipal.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

Ausgaben

System.Object

None

Hinweise

Unterstützt für alle Analysis Services-Instanzen Derzeit nicht vom PowerBI Premium-Produkt unterstützt. Es wird in Zukunft unterstützt.