Remove-LocalGroup
ローカル セキュリティ グループを削除します。
構文
InputObject
Remove-LocalGroup
[-InputObject] <LocalGroup[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Remove-LocalGroup
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Remove-LocalGroup
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-LocalGroup コマンドレットは、ローカル セキュリティ グループを削除します。 このコマンドレットは、ローカル グループのみを削除します。 そのグループに属するユーザー アカウント、コンピューター アカウント、またはグループ アカウントは削除されません。 削除されたグループを回復することはできません。
グループを削除し、同じグループ名を持つ別のグループを作成する場合は、新しいグループの新しいアクセス許可を設定する必要があります。 新しいグループは、グループに割り当てられたアクセス許可を継承しません。
注
Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。
例
例 1: セキュリティ グループを削除する
Remove-LocalGroup -Name "SecurityGroup04"
このコマンドは、SecurityGroup04 という名前のグループを削除します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
このコマンドレットが削除するセキュリティ グループの配列を指定します。 グループを取得するには、Get-LocalGroup コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Microsoft.PowerShell.Commands.LocalGroup[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InputObject
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
このコマンドレットが削除するセキュリティ グループの名前の配列を指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SID
このコマンドレットが削除するセキュリティ グループのセキュリティ ID (SID) の配列を指定します。
パラメーターのプロパティ
| 型: | |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SecurityIdentifier
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
System.Management.Automation.SecurityAccountsManager.LocalGroup
セキュリティ グループをこのコマンドレットにパイプできます。
String
このコマンドレットに文字列をパイプできます。
SecurityIdentifier
SID をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは出力を返しません。
メモ
Windows PowerShell には、Remove-LocalGroupの次のエイリアスが含まれています。
rlg
このコマンドレットは、次の既定のグループを削除できません。
- 管理者
- バックアップオペレーター
- 暗号化演算子
- 分散 COM ユーザー
- イベント ログ リーダー
- ゲスト
- Hyper-V 管理者
- IIS_IUSRS
- ネットワーク構成オペレーター
- パフォーマンス ログ ユーザー
- パフォーマンス監視ユーザー
- Power Users
- リモート デスクトップ ユーザー
- リモート管理ユーザー
- レプリケーター
- ユーザー
- WinRMRemoteWMIUsers__
PrincipalSource プロパティは、LocalUser、LocalGroup、および LocalPrincipal オブジェクトのプロパティであり、そのオブジェクトのソースを記述します。 考えられるソースは次のとおりです。
- ローカル
- Active Directory
- Microsoft Entra グループ
- Microsoft アカウント
PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。