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

Remove-LocalGroup

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

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

Синтаксис

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-LocalGroup удаляет локальные группы безопасности. Этот командлет удаляет только локальную группу. Он не удаляет учетные записи пользователей, учетные записи компьютера или учетные записи групп, принадлежащие этой группе. Удалить удаленную группу нельзя.

Если удалить группу, а затем создать другую группу с тем же именем группы, необходимо задать новые разрешения для новой группы. Новая группа не наследует разрешения, назначенные группе.

Заметка

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

Примеры

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

Remove-LocalGroup -Name "SecurityGroup04"

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

Параметры

-Confirm

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

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

-InputObject

Указывает массив групп безопасности, которые этот командлет удаляет. Чтобы получить группы, используйте командлет Get-LocalGroup.

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

-Name

Задает массив имен групп безопасности, которые удаляет этот командлет.

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

-SID

Задает массив идентификаторов безопасности (SID) групп безопасности, которые этот командлет удаляет.

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

-WhatIf

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

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

Входные данные

System.Management.Automation.SecurityAccountsManager.LocalGroup

Вы можете передать группу безопасности в этот командлет.

String

Вы можете передать строку в этот командлет.

SecurityIdentifier

Этот командлет можно передать идентификатор безопасности.

Выходные данные

None

Этот командлет не возвращает выходные данные.

Примечания

Windows PowerShell включает следующие псевдонимы для Remove-LocalGroup:

  • rlg

Этот командлет не может удалить следующие группы по умолчанию:

  • Администраторы
  • Операторы резервного копирования
  • Криптографические операторы
  • Распределенные com-пользователи
  • Средства чтения журналов событий
  • Гости
  • Администраторы Hyper-V
  • IIS_IUSRS
  • Операторы конфигурации сети
  • Пользователи журнала производительности
  • Пользователи монитора производительности
  • Power Users
  • Пользователи удаленного рабочего стола
  • Пользователи удаленного управления
  • Репликатор
  • Пользователей
  • WinRMRemoteWMIUsers__

Свойство PrincipalSource — это свойство LocalUser, LocalGroupи объекты LocalPrincipal, описывающие источник объекта. Возможные источники:

  • Местный
  • Active Directory
  • Группа Microsoft Entra
  • Учетная запись Майкрософт

PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий свойство пусто.