Remove-LocalGroupMember

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

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

Синтаксис

Group 

Remove-LocalGroupMember
    [-Group] <LocalGroup>
    [-Member] <LocalPrincipal[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier 

Remove-LocalGroupMember
    [-Member] <LocalPrincipal[]>
    [-SID] <SecurityIdentifier>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Remove-LocalGroupMember удаляет пользователей или группы из локальной группы.

Замечание

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

Примеры

Пример 1. Удаление участников из группы "Администраторы"

$members = "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Remove-LocalGroupMember -Group "Administrators" -Member $members

Эта команда удаляет несколько членов из локальной группы администраторов. Члены, удаляемые этим командлетом, включают локальную учетную запись пользователя, учетную запись Майкрософт, учетную запись Microsoft Entra и группу доменов. В этом примере используется значение заполнителя для имени пользователя учетной записи в Outlook.com.

Параметры

-Confirm

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

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

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

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

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

-Group

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

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

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

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

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

-Member

Указывает массив пользователей или групп, которые этот командлет удаляет из группы безопасности. Вы можете указать пользователей или группы по имени, идентификатору безопасности или объектам LocalPrincipal. Укажите строки безопасности в S-R-I-S-S. . . формат.

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

Тип:

Microsoft.PowerShell.Commands.LocalPrincipal[]

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

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

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

-Name

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

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

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

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

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

-SID

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

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

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

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

SecurityIdentifier
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов: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.

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

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

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

String

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

SecurityIdentifier

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

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

None

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

Примечания

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

  • rlgm

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

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

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