Rename-Computer
Переименовывает компьютер.
Синтаксис
Default (По умолчанию)
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.
Можно использовать параметр ComputerNameRename-Computer, даже если ваш компьютер не настроен для выполнения удаленных команд.
Свойства параметров
| Тип: | String |
| Default value: | Local Computer |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainCredential
Указывает учетную запись пользователя, которая имеет разрешение на подключение к домену. Явные учетные данные необходимы для переименования компьютера, присоединенного к домену.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например один, созданный командлетом Get-Credential.
При вводе имени пользователя этот командлет запрашивает пароль.
Чтобы указать учетную запись пользователя, которая имеет разрешение на подключение к компьютеру, указанному параметром ComputerName, используйте параметр LocalCredential.
Свойства параметров
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LocalCredential
Указывает учетную запись пользователя, которая имеет разрешение на подключение к компьютеру, указанному параметром ComputerName. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например один, созданный командлетом Get-Credential.
При вводе имени пользователя этот командлет запрашивает пароль.
Чтобы указать учетную запись пользователя с разрешением на подключение к домену, используйте параметр DomainCredential.
Свойства параметров
| Тип: | PSCredential |
| Default value: | Current User |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NewName
Задает новое имя компьютера. Этот параметр является обязательным.
Стандартные имена могут содержать буквы (a-z), (A-Z), числа (0-9) и дефисы (-), но не пробелы или точки (.). Имя может не состоять полностью из цифр и не может превышать 63 символов.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает результаты команды. В противном случае этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Protocol
Указывает, какой протокол используется для переименования компьютера. Допустимые значения для этого параметра: WSMan и DCOM. Значением по умолчанию является DCOM.
Этот параметр появился в Windows PowerShell 3.0.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Допустимые значения: | DCOM, WSMan |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Restart
Указывает, что этот командлет перезагрузит компьютер, который был переименован. Для эффективного изменения часто требуется перезапуск.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WsmanAuthentication
Указывает механизм, используемый для проверки подлинности учетных данных пользователя, когда этот командлет использует протокол WSMan. Допустимые значения для этого параметра:
- Базовая
- CredSSP
- По умолчанию
- Обзор
- Kerberos
- Переговоры
Значение по умолчанию — Default.
Для получения дополнительной информации о значениях этого параметра см. перечисление AuthenticationMechanism.
Предупреждение
Проверка подлинности поставщика служб безопасности учетных данных (CredSSP), в которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, можно использовать для управления > сетевом сеансе.
Этот параметр появился в Windows PowerShell 3.0.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Допустимые значения: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
None
Этот командлет не имеет параметров, которые принимают входные данные по значению. Однако можно передать значения свойств ComputerName и NewName объектов в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
RenameComputerChangeInfo
При использовании параметра PassThru этот командлет возвращает объект RenameComputerChangeInfo.
