Remove-RoleMember

  • リファレンス
モジュール:
SQLServer

特定のデータベースの特定のロールからメンバーを削除します。

構文

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

説明

Remove-RoleMember コマンドレットは、入力値に応じて、特定のデータベースの特定のロールから既存のメンバーを削除します。

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

例

例 1: パイプラインを使用してロール メンバーを削除する

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"

例 2: 名前を使用してロール メンバーを削除する

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

パラメーター

-ApplicationId

サービス プリンシパルのアプリケーション ID。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CertificateThumbprint

サービス プリンシパルの証明書の拇印。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

このパラメーターを指定すると、渡されたユーザー名とパスワードが、指定した Analysis Server インスタンスへの接続に使用されます。 資格情報が指定されていない場合は、ツールを実行しているユーザーの既定の Windows アカウントが使用されます。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Database

ロールが属するデータベース名。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DatabaseRole

メンバーを削除する Microsoft.AnalysisServices.Role オブジェクト。 (多次元メタデータのみ)

型:Role
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MemberName

削除するメンバーの名前。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ModelRole

パイプライン ロール オブジェクト。

型:ModelRole
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProgressAction

スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新 (Write-Progress コマンドレットによって生成された進行状況バーなど) に対する PowerShell の応答方法を決定します。 Write-Progress コマンドレットは、コマンドの状態を示す進行状況バーを作成します。

型:ActionPreference
Aliases:proga
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RoleName

メンバーを削除する必要があるロール名。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Server

必要に応じて、SQLAS プロバイダー ディレクトリにない場合に接続するサーバー インスタンスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePrincipal

この接続がサービス プリンシパルを使用していることを指定します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TenantId

サービス プリンシパルのテナント ID。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.AnalysisServices.Role

Microsoft.AnalysisServices.Tabular.ModelRole

メモ

すべての Analysis Services インスタンスでサポートされます