Share via

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SID

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

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

String

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

SecurityIdentifier

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

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

None

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

Примечания

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

  • rlg

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

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

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

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

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