Rename-Computer
Переименовывает компьютер.
Синтаксис
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
можно использовать, даже если компьютер не настроен для выполнения удаленных команд.
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
), цифры (0-9
) и дефисы (-
), но без пробелов или точек (.
).a-z
Имя не может состоять полностью из цифр и не может содержать более 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
- Default
- Digest (дайджест)
- Kerberos
- Согласование
Значение по умолчанию ― Default.
Дополнительные сведения о значениях этого параметра см. в разделе AuthenticationMechanism Enumeration.
Предупреждение
Проверка подлинности поставщика службы безопасности учетных данных (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
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра PassThru этот командлет возвращает объект RenameComputerChangeInfo .
Примечания
Этот командлет доступен только на платформах Windows.