Remove-LocalGroup

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

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

Синтаксис

InputObject 

Remove-LocalGroup
    [-InputObject] <LocalGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

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

SecurityIdentifier 

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

Описание

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

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

Замечание

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

Примеры

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

Remove-LocalGroup -Name "SecurityGroup04"

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

Параметры

-Confirm

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

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

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

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

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

-InputObject

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

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

Тип:

Microsoft.PowerShell.Commands.LocalGroup[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Name

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

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

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-SID

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

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

Тип:

SecurityIdentifier[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-WhatIf

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

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

Тип:SwitchParameter
Значение по умолчанию: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.

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

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

String

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

SecurityIdentifier

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

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

None

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

Примечания

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

  • rlg

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

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

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

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

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