Remove-LocalGroup

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

ローカル セキュリティ グループを削除します。

構文

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-LocalGroup コマンドレットは、ローカル セキュリティ グループを削除します。 このコマンドレットは、ローカル グループのみを削除します。 そのグループに属するユーザー アカウント、コンピューター アカウント、またはグループ アカウントは削除されません。 削除されたグループを回復することはできません。

グループを削除し、同じグループ名を持つ別のグループを作成する場合は、新しいグループの新しいアクセス許可を設定する必要があります。 新しいグループは、グループに割り当てられたアクセス許可を継承しません。

Note

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

例

例 1: セキュリティ グループを削除する

Remove-LocalGroup -Name "SecurityGroup04"

このコマンドは、SecurityGroup04 という名前のグループを削除します。

パラメーター

-Confirm

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

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

-InputObject

このコマンドレットが削除するセキュリティ グループの配列を指定します。 グループを取得するには、 Get-LocalGroup コマンドレットを使用します。

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

-Name

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

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

-SID

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

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

-WhatIf

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

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

入力

System.Management.Automation.SecurityAccountsManager.LocalGroup

セキュリティ グループをこのコマンドレットにパイプできます。

String

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

SecurityIdentifier

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

出力

None

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

メモ

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

  • rlg

このコマンドレットは、次の既定のグループを削除できません。

  • 管理者
  • Backup Operators
  • Cryptographic Operators
  • Distributed COM Users
  • イベント ログ リーダー
  • ゲスト
  • Hyper-V 管理者
  • IIS_IUSRS
  • Network Configuration Operators
  • Performance Log Users
  • パフォーマンス モニター ユーザー
  • パワー ユーザー
  • Remote Desktop Users
  • リモート管理ユーザー
  • レプリケーター
  • ユーザー
  • WinRMRemoteWMIUsers__

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

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

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