New-LocalGroup

Модуль:
Microsoft.PowerShell.LocalAccounts Module

Создает локальную группу безопасности.

Синтаксис

Default (По умолчанию) 

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

Описание

Командлет New-LocalGroup создает локальную группу безопасности в диспетчере учетных записей безопасности.

Замечание

Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.

Примеры

Пример 1. Создание группы безопасности

New-LocalGroup -Name "SecurityGroup04"

Эта команда создает группу с именем SecurityGroup04.

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Указывает комментарий для группы. Максимальная длина — 256 символов.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

Указывает имя группы. Максимальная длина — 48 символов.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position: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. Для более ранних версий атрибут пуст.