次の方法で共有

New-LocalGroup

モジュール:
Microsoft.PowerShell.LocalAccounts Module

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

構文

Default (既定) 

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
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置: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を参照してください。

入力

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 オペレーティング システムでのみサポートされます。 以前のバージョンの場合、プロパティは空白です。