Rename-Computer

Ссылка

Модуль:: Microsoft.PowerShell.Management

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

Синтаксис

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

Описание

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

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

Примеры

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

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

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

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

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

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

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

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

Параметры

-ComputerName

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

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

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

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

-Confirm

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

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

-DomainCredential

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

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

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

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

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

-Force

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

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

-LocalCredential

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

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

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

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

-NewName

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

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

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

-PassThru

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

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

-Protocol

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

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

Тип:	String
Допустимые значения:	DCOM, WSMan
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Restart

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

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

-WhatIf

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

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

-WsmanAuthentication

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

базовый
CredSSP
по умолчанию
дайджест
Kerberos
согласование

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

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

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

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

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

Тип:	String
Допустимые значения:	Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

None

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

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