New-LocalGroup

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

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

構文

New-LocalGroup
   [-Description <String>]
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

コマンドレットは New-LocalGroup 、セキュリティ アカウント マネージャーにローカル セキュリティ グループを作成します。

注意

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

例

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

New-LocalGroup -Name "SecurityGroup04"

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

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

グループのコメントを指定します。 最大長は 48 文字です。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

グループの名前を指定します。 最大長は 256 文字です。

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

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

出力

System.Management.Automation.SecurityAccountsManager.LocalGroup

このコマンドレットは、作成されたセキュリティ グループを表す LocalGroup オブジェクトを返します。

メモ

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

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

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