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. Переименование удаленного компьютера

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

Параметр 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), (),A-Z цифры () и дефисы (0-9-), но пробелы или периоды (.). Имя может не состоять полностью из цифр и не может превышать 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
  • По умолчанию
  • Дайджест
  • 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 объектов в этот командлет.

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

None

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

RenameComputerChangeInfo

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

Примечания

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