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

Add-LocalGroupMember

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

Добавляет участников в локальную группу.

Синтаксис

Add-LocalGroupMember
   [-Group] <LocalGroup>
   [-Member] <LocalPrincipal[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Add-LocalGroupMember добавляет пользователей или группы в локальную группу безопасности. Все права и разрешения, назначенные группе, назначаются всем членам этой группы.

Члены группы "Администраторы" на локальном компьютере имеют разрешения полного управления на этом компьютере. Ограничение количества пользователей в группе "Администраторы".

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

Примечание.

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

Примеры

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

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

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

Параметры

-Confirm

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

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

-Group

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

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

-Member

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

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

-Name

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

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

-SID

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

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

-WhatIf

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

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

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

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

String

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

SecurityIdentifier

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

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

None

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

Примечания

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

  • algm

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

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

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

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