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

Rename-LocalGroup

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

Переименовывает локальную группу безопасности.

Синтаксис

Rename-LocalGroup
      [-InputObject] <LocalGroup>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-LocalGroup
      [-Name] <String>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-LocalGroup
      [-NewName] <String>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Rename-LocalGroup переименовывает локальную группу безопасности.

Заметка

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

Примеры

Пример 1. Изменение имени группы

PS C:\> Rename-LocalGroup -Name "SecurityGroup" -NewName "SecurityGroup04"

Эта команда переименовывает группу безопасности с именем SecurityGroup.

Параметры

-Confirm

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

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

-InputObject

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

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

-Name

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

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

-NewName

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

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

-SID

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

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

-WhatIf

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

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

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

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

String

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

SecurityIdentifier

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

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

None

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

Примечания

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

  • rnlg

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

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

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