New-LocalGroup
创建本地安全组。
语法
New-LocalGroup
[-Description <String>]
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-LocalGroup
cmdlet 在安全帐户管理器中创建本地安全组。
注意
Microsoft.PowerShell.LocalAccounts 模块在 64 位系统上的 32 位 PowerShell 中不可用。
示例
示例 1:创建安全组
New-LocalGroup -Name "SecurityGroup04"
此命令创建名为 SecurityGroup04 的组。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
指定组的注释。 最大长度为 48 个字符。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Name
指定组的名称。 最大长度为 256 个字符。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
可以通过管道将字符串传递给此 cmdlet。
输出
System.Management.Automation.SecurityAccountsManager.LocalGroup
此 cmdlet 返回表示创建的安全组的 LocalGroup 对象。
备注
Windows PowerShell 包含以下 New-LocalGroup
别名:
nlg
PrincipalSource属性是LocalUser、LocalGroup和LocalPrincipal对象上用于描述对象的源的属性。 可能的源如下所示:
Local
Active Directory
AzureAD
MicrosoftAccount
PrincipalSource 仅受 Windows 10、Windows Server 2016 和更高版本的 Windows 操作系统支持。 对于早期版本,该属性为空。