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

Rename-Computer

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

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

Синтаксис

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

Описание

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

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

Этот командлет был введён в Windows PowerShell 3.0.

Примеры

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

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

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

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

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

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

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

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

Параметры

-ComputerName

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

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

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

Тип: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. По умолчанию используется текущий пользователь.

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

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

Чтобы указать учетную запись пользователя с разрешением на подключение к домену, используйте параметр 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

-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
  • Переговоры

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

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

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

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

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

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

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

None

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

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

None

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

RenameComputerChangeInfo

При использовании параметра PassThru этот командлет возвращает объект RenameComputerChangeInfo.

Примечания

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