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

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

手記

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

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

管理者
バックアップ演算子
暗号化演算子
分散 COM ユーザー
イベントログリーダー
お客様
Hyper-V 管理者
IIS_IUSRS
ネットワーク構成オペレーター
パフォーマンスログユーザー
パフォーマンスモニターのユーザー
Power Users
リモートデスクトップユーザー
リモート管理ユーザー
Replicator
ユーザー
WinRMRemoteWMIUsers__

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

地元の
Active Directory
Microsoft Entra グループ
Microsoft アカウント

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