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

Rename-Computer

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

Переименовывает компьютер.

Синтаксис

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Rename-Computer переименовывает локальный или удаленный компьютер. Он переименовывает один компьютер в каждой команде.

Этот командлет впервые появился в Windows PowerShell 3.0.

Примеры

Пример 1. Переименование локального компьютера

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

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

Пример 2. Переименование удаленного компьютера

Эта команда переименовывает компьютер в Srv01Server001. Компьютер не перезагружается.

Параметр DomainCredential указывает учетные данные пользователя, имеющего разрешение на переименование компьютеров в домене.

Параметр Force подавляет запрос подтверждения.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Параметры

-ComputerName

Переименовывает указанный удаленный компьютер. По умолчанию это локальный компьютер.

Введите имя NetBIOS, IP-адрес или полное доменное имя удаленного компьютера. Чтобы указать локальный компьютер, введите имя компьютера, точку (.) или localhost.

Этот параметр не зависит от удаленного взаимодействия PowerShell. Параметр ComputerNameRename-Computer можно использовать, даже если компьютер не настроен для выполнения удаленных команд.

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainCredential

Указывает учетную запись пользователя, имеющую разрешение на подключение к домену. Для переименования компьютера, присоединенного к домену, необходимо явно указать учетные данные.

Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , например созданный командлетом Get-Credential .

При вводе имени пользователя этот командлет запрашивает пароль.

Чтобы указать учетную запись пользователя, имеющую разрешение на подключение к компьютеру, который задается параметром ComputerName, используйте параметр LocalCredential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Указывает учетную запись пользователя, имеющую разрешение на подключение к компьютеру, заданному параметром ComputerName. По умолчанию используется текущий пользователь.

Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential , например созданный командлетом Get-Credential .

При вводе имени пользователя этот командлет запрашивает пароль.

Чтобы указать учетную запись, имеющую разрешение на подключение к домену, используйте параметр DomainCredential.

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Задает новое имя для компьютера. Это обязательный параметр.

Стандартные имена могут содержать буквы (), (A-Z), цифры (0-9) и дефисы (-), но без пробелов или точек (.).a-z Имя не может состоять полностью из цифр и не может быть длиннее 63 символов.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Возвращает результаты выполнения команды. В противном случае командлет не формирует никаких выходных данных.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

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

  • Основной
  • CredSSP
  • Default
  • Digest (дайджест)
  • Kerberos
  • Согласование

Значение по умолчанию ― Default.

Дополнительные сведения о значениях этого параметра см. в разделе Перечисление AuthenticationMechanism.

Предупреждение

Проверка подлинности поставщика службы безопасности учетных данных (CredSSP), при которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности в нескольких ресурсах, таких как доступ к удаленной сетевой папке. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, передаваемые ему учетные данные можно использовать для управления > сетевым сеансом.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

Этот командлет не имеет параметров, которые принимают входные данные по значению. Тем не менее в этот командлет можно передавать значения свойств ComputerName и NewName объектов.

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

ComputerChangeInfo

Этот командлет возвращает объект ComputerChangeInfo , если указан параметр PassThru . В противном случае не возвращает никаких выходных данных.

Примечания

Этот командлет доступен только на платформах Windows.