Set-LocalGroup
Изменяет локальную группу безопасности.
Синтаксис
InputObject
Set-LocalGroup
[-InputObject] <LocalGroup>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Set-LocalGroup
[-Name] <String>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalGroup
[-SID] <SecurityIdentifier>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-LocalGroup изменяет локальную группу безопасности.
Примеры
Пример 1. Изменение описания группы
Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."
Эта команда изменяет описание локальной группы.
Замечание
Модуль Microsoft.PowerShell.LocalAccounts недоступен в 32-разрядной версии PowerShell в 64-разрядной системе.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Указывает комментарий для группы. Максимальная длина — 48 символов.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | 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
Указывает идентификатор безопасности группы безопасности, которая изменяет этот командлет.
Свойства параметров
| Тип: | 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 включает следующие псевдонимы для Set-LocalGroup:
slg
Свойство PrincipalSource является свойством объектов LocalUser, LocalGroupи LocalPrincipal, описывающим источник объекта. Возможные источники:
- Локальный
- Active Directory
- Группа Microsoft Entra
- Учетная запись Майкрософт
PrincipalSource поддерживается только в Windows 10, Windows Server 2016 и более поздних версиях операционной системы Windows. Для более ранних версий атрибут пуст.
