Remove-RoleMember

Entfernt ein Mitglied aus der bestimmten Rolle einer angegebenen Datenbank.

Syntax

Remove-RoleMember
      [-MemberName] <String>
      [-Database] <String>
      [-RoleName] <String>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-RoleMember
      [-MemberName] <String>
      -DatabaseRole <Role>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-RoleMember
      [-MemberName] <String>
      -ModelRole <ModelRole>
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-RoleMember
      [-Server <String>]
      [-Credential <PSCredential>]
      [-ServicePrincipal]
      [-ApplicationId <String>]
      [-TenantId <String>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-RoleMember entfernt ein vorhandenes Element aus einer bestimmten Rolle einer bestimmten Datenbank abhängig von den Eingabewerten.

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

Beispiele

Beispiel 1: Entfernen von Rollenmitglied mithilfe der Pipeline

PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles> $roles = Get-Children
PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles> $roles[0] | Remove-RoleMember -MemberName "foo\user1"

Beispiel 2: Entfernen des Rollenmitglieds mithilfe des Namens

PS SQLServer:\SQLAS\machine\instance\Databases\DB1\Roles> Remove-RoleMember -MemberName "foo\user1" -Database "DB1" -RoleName "myRole"

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 Zertifikat-Fingerabdruck 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

Das Microsoft.AnalysisServices.Role-Objekt, aus dem das Mitglied entfernt werden soll. (nur mehrdimensionale Metadaten)

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

-MemberName

Der Name des Mitglieds, das entfernt werden soll.

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

-ModelRole

Das Pipelinerollenobjekt.

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

-RoleName

Der Name der Rolle, aus der das Mitglied entfernt werden soll.

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

-Server

Gibt optional die Serverinstanz an, mit der eine Verbindung hergestellt werden soll, wenn sie sich 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

Hinweise

Unterstützt für alle Analysis Services-Instanzen