Remove-LocalGroupMember

  • リファレンス
モジュール:
Microsoft.PowerShell.LocalAccounts

ローカル グループからメンバーを削除します。

構文

Remove-LocalGroupMember
      [-Group] <LocalGroup>
      [-Member] <LocalPrincipal[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-LocalGroupMember コマンドレットは、ローカル グループからユーザーまたはグループを削除します。

Note

Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。

例

例 1: Administrators グループからメンバーを削除する

$members = "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Remove-LocalGroupMember -Group "Administrators" -Member $members

このコマンドは、ローカルの Administrators グループから複数のメンバーを削除します。 このコマンドレットによって削除されるメンバーには、ローカル ユーザー アカウント、Microsoft アカウント、Microsoft Entra アカウント、ドメイン グループが含まれます。 この例では、Outlook.com のアカウントのユーザー名にプレースホルダー値を使用します。

パラメーター

-Confirm

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

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

-Group

このコマンドレットがメンバーを削除するセキュリティ グループを指定します。

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

-Member

このコマンドレットがセキュリティ グループから削除するユーザーまたはグループの配列を指定します。 ユーザーまたはグループは、名前、セキュリティ ID (SID)、または LocalPrincipal オブジェクトで指定できます。 S-R-I-S-S で SID 文字列を指定します。 . . format。

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

-Name

このコマンドレットがメンバーを削除するセキュリティ グループの名前を指定します。

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

-SID

このコマンドレットがメンバーを削除するセキュリティ グループのセキュリティ ID を指定します。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

ローカル プリンシパルをこのコマンドレットにパイプできます。

String

このコマンドレットに文字列をパイプできます。

SecurityIdentifier

SID をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

Windows PowerShell には、 Remove-LocalGroupMemberの次のエイリアスが含まれています。

  • rlgm

PrincipalSource プロパティは、オブジェクトのソースを記述する LocalUser、LocalGroup、および LocalPrincipal オブジェクトのプロパティです。 考えられるソースは次のとおりです。

  • ローカル
  • Active Directory
  • Microsoft Entra グループ
  • Microsoft アカウント

PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。