次の方法で共有

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

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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 オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。