Rename-Computer
Переименовывает компьютер.
Синтаксис
Default (По умолчанию)
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 подавляет запрос на подтверждение.
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 |
-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.
Примечания
Этот командлет доступен только на платформах Windows.
