Condividi tramite


Add-RoleMember

Aggiunge un membro a un ruolo specifico di un database specifico.

Sintassi

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

Descrizione

Il cmdlet Add-RoleMember aggiunge un membro valido a un ruolo specifico di un database specifico a seconda dei valori di input.

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

Esempio

Esempio 1: Aggiungere un membro al ruolo usando la 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"

Questo comando aggiunge un membro al primo ruolo di un determinato database.

Esempio 2: Aggiungere un membro al ruolo usando la pipeline in tabulare 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]

Aggiungere un membro al primo ruolo di un determinato database usando parametri denominati per un database tabulare con livello di compatibilità 1200 o superiore.

Esempio 3: Aggiungere un membro al ruolo usando il nome

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

Aggiungere un membro al ruolo del database usando il nome del ruolo

Parametri

-ApplicationId

ID applicazione per l'entità servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificateThumbprint

Identificazione personale del certificato per l'entità servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Se si specifica questo parametro, verranno usati il nome utente e la password passati per connettersi all'istanza di Analysis Server specificata. Se non viene specificato alcun account di windows predefinito dell'utente che esegue lo strumento, verrà usato.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Database

Nome del database a cui appartiene il ruolo.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DatabaseRole

Microsoft.AnalysisServices.Role a cui aggiungere un membro. Non applicabile ai database tabulari con livello di compatibilità 1200 o superiore.

Tipo:Role
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MemberName

Nome del membro che deve essere aggiunto al ruolo.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ModelRole

Ruolo del modello a cui aggiungere il membro.

Tipo:ModelRole
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:ActionPreference
Alias:proga
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RoleName

Nome del ruolo a cui deve essere aggiunto il membro.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Server

Facoltativamente, specifica l'istanza del server a cui connettersi se non è attualmente presente nella directory del provider SQLAS.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePrincipal

Specifica che la connessione utilizza l'entità servizio.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantId

ID tenant per l'entità servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

Output

System.Object

None

Note

Supportato in tutte le istanze di Analysis Services Attualmente non supportate dal prodotto PowerBI Premium. Sarà supportato in futuro.