Rename-Computer
Bilgisayarı yeniden adlandırır.
Sözdizimi
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Rename-Computer
cmdlet'i yerel bilgisayarı veya uzak bilgisayarı yeniden adlandırır. Her komutta bir bilgisayarı yeniden adlandırır.
Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.
Örnekler
Örnek 1: Yerel bilgisayarı yeniden adlandırma
Bu komut, yerel bilgisayarı Server044
olarak yeniden adlandırır ve değişikliğin etkili olması için yeniden başlatır.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Örnek 2: Uzak bilgisayarı yeniden adlandırma
Bu komut, Srv01
bilgisayarı Server001
olarak yeniden adlandırır. Bilgisayar yeniden başlatılmadı.
DomainCredential parametresi, etki alanındaki bilgisayarları yeniden adlandırma izni olan bir kullanıcının kimlik bilgilerini belirtir.
Force parametresi onay istemini gizler.
$renameParams = @{
ComputerName = "Srv01"
NewName = "Server001"
DomainCredential = "Domain01\Admin01"
Force = $true
}
Rename-Computer @renameParams
Parametreler
-ComputerName
Belirtilen uzak bilgisayarı yeniden adlandırır. Varsayılan değer yerel bilgisayardır.
NetBIOS adını, IP adresini veya uzaktaki bilgisayarın tam etki alanı adını yazın.
Yerel bilgisayarı belirtmek için bilgisayar adını, bir nokta (.
) veya localhost
yazın.
Bu parametre PowerShell uzaktan iletişimine bağlı değildir.
Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile Rename-Computer
parametresini kullanabilirsiniz.
Tür: | String |
Position: | Named |
Default value: | Local Computer |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DomainCredential
Etki alanına bağlanma izni olan bir kullanıcı hesabı belirtir. Etki alanına katılmış bir bilgisayarı yeniden adlandırmak için açık kimlik bilgileri gereklidir.
User01
veya Domain01\User01
gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan gibi Get-Credential
nesnesi girin.
Bir kullanıcı adı yazarsanız, bu cmdlet sizden parola ister.
ComputerName parametresi tarafından belirtilen bilgisayara bağlanma iznine sahip bir kullanıcı hesabı belirtmek için LocalCredential parametresini kullanın.
Tür: | PSCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-LocalCredential
ComputerName parametresi tarafından belirtilen bilgisayara bağlanma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
User01
veya Domain01\User01
gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan gibi Get-Credential
nesnesi girin.
Bir kullanıcı adı yazarsanız, bu cmdlet sizden parola ister.
Etki alanına bağlanma izni olan bir kullanıcı hesabı belirtmek için DomainCredential parametresini kullanın.
Tür: | PSCredential |
Position: | Named |
Default value: | Current User |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-NewName
Bilgisayar için yeni bir ad belirtir. Bu parametre gereklidir.
Standart adlar harf (a-z
), (A-Z
), sayılar (0-9
) ve kısa çizgi (-
) içerebilir, ancak boşluk veya nokta (.
) içeremez. Ad tamamen basamaklardan oluşamayabilir ve 63 karakterden uzun olmayabilir
Tür: | String |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
Komutun sonuçlarını döndürür. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Restart
Bu cmdlet'in yeniden adlandırılan bilgisayarı yeniden başlatdığını gösterir. Değişikliğin etkili olması için genellikle yeniden başlatma gerekir.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WsmanAuthentication
Bu cmdlet WSMan protokolunu kullandığında kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:
- Temel
- CredSSP
- Varsayılan
- özet
- Kerberos
- Anlaşma
Varsayılan değer Default'dir.
Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. Kimlik Doğrulama Mekanizması Enumerasyonu.
Uyarı
Kimlik Bilgileri Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, kullanıcı kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, ona geçirilen kimlik bilgileri ağ oturumunu > denetlemek için kullanılabilir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | String |
Kabul edilen değerler: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Bu cmdlet'in değere göre giriş kabul eden hiçbir parametresi yok. Ancak, bu cmdlet'e geçirebilmek için nesnelerin ComputerName ve NewName özelliklerinin değerlerini kullanabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet herhangi bir çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet bir RenameComputerChangeInfo nesnesi döndürür.
Notlar
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.