Rename-Computer
Átnevez egy számítógépet.
Syntax
Default (Alapértelmezett)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Rename-Computer parancsmag átnevezi a helyi számítógépet vagy egy távoli számítógépet.
Minden parancsban egy számítógépet nevez át.
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Példák
1. példa: A helyi számítógép átnevezése
Ez a parancs átnevezi a helyi számítógépet Server044, majd újraindítja a módosítás hatékonyságának érdekében.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
2. példa: Távoli számítógép átnevezése
Ez a parancs átnevezi a Srv01 számítógépet Server001. A számítógép nem indul újra.
A DomainCredential paraméter egy olyan felhasználó hitelesítő adatait adja meg, aki jogosult a tartomány számítógépeinek átnevezésére.
A Force paraméter letiltja a megerősítési kérést.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Paraméterek
-ComputerName
Átnevezi a megadott távoli számítógépet. Az alapértelmezett beállítás a helyi számítógép.
Írja be egy távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét.
A helyi számítógép megadásához írja be a számítógép nevét, egy pont (.) vagy localhost.
Ez a paraméter nem támaszkodik a PowerShell távoli elérésre.
A Rename-Computer paraméterét akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | Local Computer |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DomainCredential
Olyan felhasználói fiókot ad meg, amely jogosult a tartományhoz való csatlakozásra. A tartományhoz csatlakoztatott számítógép átnevezéséhez explicit hitelesítő adatokra van szükség.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.
Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a ComputerName paraméter által megadott számítógéphez való csatlakozásra, használja a LocalCredential paramétert.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LocalCredential
Olyan felhasználói fiókot ad meg, amely jogosult csatlakozni a ComputerName paraméter által megadott számítógéphez. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.
Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a tartományhoz való csatlakozásra, használja a DomainCredential paramétert.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current User |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NewName
A számítógép új nevét adja meg. Ez a paraméter kötelező.
A standard név tartalmazhat betűket (a-z), (A-Z), számokat (0-9) és kötőjeleket (-), de nem tartalmazhat szóközöket vagy pontokat (.). A név nem állhat teljes egészében számjegyekből, és legfeljebb 63 karakter hosszúságú lehet
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
A parancs eredményeit adja vissza. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Protocol
Megadja, hogy melyik protokollt használja a számítógép átnevezéséhez. A paraméter elfogadható értékei a következők: WSMan és DCOM. Az alapértelmezett érték a DCOM.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | DCOM, WSMan |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Restart
Azt jelzi, hogy ez a parancsmag újraindítja az átnevezett számítógépet. A módosítás hatékonyságának eléréséhez gyakran szükség van újraindításra.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WsmanAuthentication
Megadja azt a mechanizmust, amely a felhasználói hitelesítő adatok hitelesítésére szolgál, amikor ez a parancsmag a WSMan protokollt használja. A paraméter elfogadható értékei a következők:
- Alapszintű
- CredSSP
- Alapértelmezett
- Összefoglaló
- Kerberos
- Tárgyalj
Az alapértelmezett érték a következő: Alapértelmezett.
A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.
Figyelmeztetés
A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatok a hálózati munkamenet > vezérlésére használhatók.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ez a parancsmag nem rendelkezik olyan paraméterekkel, amelyek érték szerint fogadják a bemenetet. Azonban a ComputerName és NewName objektumtulajdonságok értékeit átiranyíthatja ehhez a parancsmaghoz.
Kimenetek
ComputerChangeInfo
Ez a parancsmag egy ComputerChangeInfo objektumot ad vissza, ha megadja a PassThru paramétert. Ellenkező esetben nem ad vissza kimenetet.