Add-RoleMember
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.