Поделиться через

New-LocalGroup

  • Ссылка
Модуль:
Microsoft.PowerShell.LocalAccounts

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

Синтаксис

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

Описание

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

Примечание.

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

Примеры

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

New-LocalGroup -Name "SecurityGroup04"

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

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value: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. Для более ранних версий свойство пусто.