Set-LocalGroup
ローカル セキュリティ グループを変更します。
構文
Set-LocalGroup
-Description <String>
[-InputObject] <LocalGroup>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-LocalGroup
-Description <String>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-LocalGroup
-Description <String>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-LocalGroup
コマンドレットは、ローカル セキュリティ グループを変更します。
例
例 1: グループの説明を変更する
Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."
このコマンドは、ローカル グループの説明を変更します。
Note
Microsoft.PowerShell.LocalAccounts モジュールは、64 ビット システムの 32 ビット PowerShell では使用できません。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
グループのコメントを指定します。 最大長は 48 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | 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
セキュリティ グループをこのコマンドレットにパイプできます。
このコマンドレットに文字列をパイプできます。
SID をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
Windows PowerShell には、 Set-LocalGroup
の次のエイリアスが含まれています。
slg
PrincipalSource プロパティは、オブジェクトのソースを記述する LocalUser、LocalGroup、および LocalPrincipal オブジェクトのプロパティです。 考えられるソースは次のとおりです。
- ローカル
- Active Directory
- Microsoft Entra グループ
- Microsoft アカウント
PrincipalSource は、Windows 10、Windows Server 2016、およびそれ以降のバージョンの Windows オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。
関連リンク
PowerShell