다음을 통해 공유

Rename-Computer

  • 참조
모듈:
Microsoft.PowerShell.Management

컴퓨터를 이름을 바꿉니다.

Syntax

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

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

cmdlet은 Rename-Computer 로컬 컴퓨터 또는 원격 컴퓨터의 이름을 바꿉니다. 각 명령에서 컴퓨터 이름을 하나씩 바꿉니다.

이 cmdlet은 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 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 의 Rename-ComputerComputerName 매개 변수를 사용할 수 있습니다.

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainCredential

도메인에 연결할 수 있는 권한을 가진 사용자 계정을 지정합니다. 도메인에 가입된 컴퓨터의 이름을 바꾸려면 명시적 자격 증명이 필요합니다.

사용자 이름(예: User01 또는 Domain01\User01)을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다.

사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.

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)을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다.

사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.

도메인에 연결할 수 있는 권한을 가진 사용자 계정을 지정하려면 DomainCredential 매개 변수를 사용합니다.

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

컴퓨터의 새 이름을 지정합니다. 이 매개 변수는 필수입니다.

표준 이름에는 문자(), (a-zA-Z), 숫자(0-9) 및 하이픈()이- 포함될 수 있지만 공백이나 마침표(.)는 포함되지 않습니다. 이름은 완전히 숫자로 구성되지 않을 수 있으며 63자보다 길지 않을 수 있습니다.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

명령의 결과를 반환합니다. 그러지 않으면 이 cmdlet에서 출력이 생성되지 않습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

이 cmdlet이 이름이 바뀐 컴퓨터를 다시 시작한다는 것을 나타냅니다. 변경 내용을 적용하려면 컴퓨터를 자주 다시 시작해야 합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

이 cmdlet이 WSMan 프로토콜을 사용할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 기본
  • CredSSP
  • 기본값
  • 다이제스트
  • Kerberos
  • Negotiate

기본값은 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

이 cmdlet에는 값별로 입력을 사용하는 매개 변수가 없습니다. 그러나 개체의 ComputerName 및 NewName 속성 값을 이 cmdlet으로 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

RenameComputerChangeInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 RenameComputerChangeInfo 개체를 반환합니다.

참고

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.