Partager via


Add-RoleMember

Ajoute un membre à un rôle spécifique d’une base de données spécifique.

Syntaxe

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

L’applet de commande Add-RoleMember ajoute un membre valide à un rôle spécifique d’une base de données spécifique en fonction des valeurs d’entrée.

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

Exemples

Exemple 1 : Ajouter un membre au rôle à l’aide du 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"

Cette commande ajoute un membre au premier rôle d’une base de données donnée.

Exemple 2 : Ajouter un membre au rôle à l’aide d’un pipeline dans Tabulaire 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]

Ajoutez un membre au premier rôle d’une base de données donnée à l’aide de paramètres nommés pour une base de données tabulaire avec le niveau de compatibilité 1200 ou supérieur.

Exemple 3 : Ajouter un membre au rôle à l’aide du nom

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

Ajouter un membre au rôle de base de données à l’aide du nom du rôle

Paramètres

-ApplicationId

ID d’application du principal de service.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificateThumbprint

Empreinte numérique du certificat pour le principal de service.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Si ce paramètre est spécifié, le nom d’utilisateur et le mot de passe transmis sont utilisés pour se connecter à l’instance d’Analysis Server spécifiée. Si aucune information d’identification n’est spécifiée, le compte Windows par défaut de l’utilisateur qui exécute l’outil sera utilisé.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Database

Nom de la base de données auquel appartient le rôle.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseRole

Microsoft.AnalysisServices.Role à laquelle ajouter un membre. Cela ne s’applique pas aux bases de données tabulaires avec le niveau de compatibilité 1200 ou supérieur.

Type:Role
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MemberName

Nom du membre qui doit être ajouté au rôle.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ModelRole

Rôle de modèle à laquelle ajouter le membre.

Type:ModelRole
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RoleName

Nom du rôle auquel le membre doit être ajouté.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Server

Spécifie éventuellement l’instance de serveur à laquelle se connecter s’il n’est pas actuellement dans le répertoire du fournisseur SQLAS.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipal

Spécifie que cette connexion utilise le principal de service.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TenantId

ID de locataire du principal de service.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

Sorties

System.Object

None

Notes

Prise en charge sur toutes les instances Analysis Services actuellement non prises en charge par le produit PowerBI Premium. Elle sera prise en charge à l’avenir.