Add-LocalGroupMember
Добавляет участников в локальную группу.
Синтаксис
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
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
Запрашивает подтверждение перед запуском 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.
Свойства параметров
| Тип: | 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.LocalGroup
Вы можете передать локальный субъект в этот командлет.
String
Вы можете передать строку в этот командлет.
SecurityIdentifier
Этот командлет можно передать идентификатор безопасности.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Add-LocalGroupMember:
algm
Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.
Свойство PrincipalSource является свойством объектов LocalUser, LocalGroupи LocalPrincipal, описывающим источник объекта. Возможные источники:
- Локальный
- Active Directory
- Группа Microsoft Entra
- Учетная запись Майкрософт
PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий атрибут пуст.
