New-LocalGroup

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

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

構文

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

説明

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

Note

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

例

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

New-LocalGroup -Name "SecurityGroup04"

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

パラメーター

-Confirm

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

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

-Description

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

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

-Name

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

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

-WhatIf

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

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

入力

String

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

出力

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

メモ

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

  • nlg

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

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

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