Add-Computer
Yerel bilgisayarı bir etki alanına veya çalışma grubuna ekleyin.
Sözdizimi
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Add-Computer
Cmdlet, yerel bilgisayarı veya uzak bilgisayarları bir etki alanına veya çalışma grubuna ekler ya da bir etki alanından diğerine taşır. Ayrıca, bilgisayar bir hesap olmadan etki alanına eklenirse bir etki alanı hesabı oluşturur.
Bir kuruluş birimi (OU) ve etki alanı denetleyicisi belirtmek veya güvenli olmayan bir birleştirme gerçekleştirmek için bu cmdlet'in parametrelerini kullanabilirsiniz.
Komutun sonuçlarını almak için Verbose ve PassThru parametrelerini kullanın.
Örnekler
Örnek 1: Etki alanına yerel bilgisayar ekleme ve bilgisayarı yeniden başlatma
Add-Computer -DomainName Domain01 -Restart
Bu komut, yerel bilgisayarı Domain01 etki alanına ekler ve değişikliğin etkili olması için bilgisayarı yeniden başlatır.
Örnek 2: Çalışma grubuna yerel bilgisayar ekleme
Add-Computer -WorkgroupName WORKGROUP-A
Bu komut yerel bilgisayarı Workgroup-A çalışma grubuna ekler.
Örnek 3: Etki alanına yerel bilgisayar ekleme
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose
Bu komut, Domain01\DC01 etki alanı denetleyicisini kullanarak yerel bilgisayarı Domain01 etki alanına ekler.
komutu, komutun sonuçları hakkında ayrıntılı bilgi almak için PassThru ve Verbose parametrelerini kullanır.
Örnek 4: OUPath parametresini kullanarak etki alanına yerel bilgisayar ekleme
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"
Bu komut, yerel bilgisayarı Domain02 etki alanına ekler. Yeni hesapların kuruluş birimini belirtmek için OUPath parametresini kullanır.
Örnek 5: Kimlik bilgilerini kullanarak etki alanına yerel bilgisayar ekleme
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force
Bu komut, Server01 bilgisayarını Domain02 etki alanına ekler. Server01 bilgisayarına bağlanma izni olan bir kullanıcı hesabı belirtmek için LocalCredential parametresini kullanır. Bilgisayarları etki alanına ekleme izni olan bir kullanıcı hesabı belirtmek için Credential parametresini kullanır. Birleştirme işlemi tamamlandıktan sonra bilgisayarı yeniden başlatmak için Restart parametresini ve kullanıcı onay iletilerini engellemek için Force parametresini kullanır.
Örnek 6: Bir bilgisayar grubunu yeni bir etki alanına taşıma
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart
Bu komut, Server01 ve Server02 bilgisayarlarını ve yerel bilgisayarı Domain01'den Domain02'ye taşır.
Etkilenen üç bilgisayara bağlanma izni olan bir kullanıcı hesabı belirtmek için LocalCredential parametresini kullanır. Bilgisayarları Domain01 etki alanından kaldırma iznine sahip bir kullanıcı hesabı belirtmek için UnjoinDomainCredential parametresini ve bilgisayarları Domain02 etki alanına ekleme izni olan bir kullanıcı hesabı belirtmek için Credential parametresini kullanır. Taşıma tamamlandıktan sonra üç bilgisayarı da yeniden başlatmak için Restart parametresini kullanır.
Örnek 7: Bilgisayarı yeni bir etki alanına taşıma ve bilgisayarın adını değiştirme
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart
Bu komut, Server01 bilgisayarını Domain02'ye taşır ve makine adını Server044 olarak değiştirir.
Komut, Server01 bilgisayarına bağlanmak ve geçerli etki alanından bağlantısını kaldırmak için geçerli kullanıcının kimlik bilgilerini kullanır. Bilgisayarı Domain02 etki alanına ekleme izni olan bir kullanıcı hesabı belirtmek için Credential parametresini kullanır.
Örnek 8: Dosyada listelenen bilgisayarları yeni bir etki alanına ekleme
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
Bu komut, dosyada Servers.txt
listelenen bilgisayarları Domain02 etki alanına ekler. Win9xUpgrade seçeneğini belirtmek için Options parametresini kullanır. Restart parametresi, birleştirme işlemi tamamlandıktan sonra yeni eklenen tüm bilgisayarları yeniden başlatır.
Örnek 9: Önceden tanımlanmış bilgisayar kimlik bilgilerini kullanarak etki alanına bilgisayar ekleme
Bu ilk komut, etki alanına Domain03
zaten katılmış bir bilgisayardan bir yönetici tarafından çalıştırılmalıdır:
New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCred
Bu komut birleşimi, etki alanına katılmış mevcut bir bilgisayarı kullanarak etki alanında önceden tanımlanmış bir ada ve geçici birleştirme parolasına sahip yeni bir bilgisayar hesabı oluşturur. Ardından, önceden tanımlanmış ada sahip bir bilgisayar, etki alanına yalnızca bilgisayar adını ve geçici birleştirme parolasını kullanarak katılır. Önceden tanımlanmış parola yalnızca birleştirme işlemini desteklemek için kullanılır ve bilgisayar birleştirmeyi tamamladıktan sonra normal bilgisayar hesabı yordamlarının bir parçası olarak değiştirilir.
Parametreler
-ComputerName
Bir etki alanına veya çalışma grubuna eklenecek bilgisayarları belirtir. Varsayılan, yerel bilgisayardır.
NetBIOS adını, İnternet Protokolü (IP) adresini veya uzak bilgisayarların her birinin tam etki alanı adını yazın. Yerel bilgisayarı belirtmek için bilgisayar adını, nokta ().
veya "localhost" yazın.
Bu parametre Windows PowerShell uzaktan iletişimini kullanmaz. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile computername parametresini Add-Computer
kullanabilirsiniz.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
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 |
-Credential
Bilgisayarları yeni bir etki alanına ekleme izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.
"User01" veya "Domain01\User01" gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential
oluşturulan nesne gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.
Bilgisayarı geçerli etki alanından kaldırma izni olan bir kullanıcı hesabı belirtmek için UnjoinDomainCredential parametresini kullanın. Uzak bilgisayara bağlanma izni olan bir kullanıcı hesabı belirtmek için LocalCredential parametresini kullanın.
Tür: | PSCredential |
Diğer adlar: | DomainCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DomainName
Bilgisayarların eklendiği etki alanını belirtir. Bilgisayarları bir etki alanına eklerken bu parametre gereklidir.
Tür: | String |
Diğer adlar: | DN, Domain |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Kullanıcı onay istemini gizler. Bu parametre olmadan, Add-Computer
her bilgisayarın eklenmesini onaylamanız gerekir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-LocalCredential
ComputerName parametresi tarafından belirtilen bilgisayarlara bağlanma izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.
"User01" veya "Domain01\User01" gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential
oluşturulan nesne gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.
Bilgisayarları yeni bir etki alanına ekleme izni olan bir kullanıcı hesabı belirtmek için Credential parametresini kullanın. Bilgisayarları geçerli etki alanından kaldırma izni olan bir kullanıcı hesabı belirtmek için UnjoinDomainCredential parametresini kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | PSCredential |
Position: | Named |
Default value: | Current user |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-NewName
Yeni etki alanındaki bilgisayar için yeni bir ad belirtir. Bu parametre yalnızca bir bilgisayar eklendiğinde veya taşındığında geçerlidir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Options
Birleştirme işlemi için Add-Computer
gelişmiş seçenekleri belirtir. Virgülle ayrılmış bir dizeye bir veya daha fazla değer girin.
Bu parametrenin kabul edilebilir değerleri şunlardır:
AccountCreate: Bir etki alanı hesabı oluşturur. Cmdlet,
Add-Computer
bir bilgisayarı etki alanına eklediğinde otomatik olarak bir etki alanı hesabı oluşturur. Bu seçenek eksiksizlik için eklenmiştir.Win9XUpgrade: Birleştirme işleminin bir Windows işletim sistemi yükseltmesinin parçası olduğunu gösterir.
UnsecuredJoin: Güvenli olmayan birleştirme gerçekleştirir. Güvenli olmayan bir birleşim istemek için Güvenli olmayan parametresini veya bu seçeneği kullanın. Makine parolası geçirmek istiyorsanız, bu seçeneği seçenekle birlikte
PasswordPass
kullanmanız gerekir.PasswordPass: Güvenli olmayan bir birleştirme gerçekleştirdikten sonra makine parolasını Credential(DomainCredential) parametresinin değerine ayarlar. Bu seçenek, Credential (DomainCredential) parametresinin değerinin kullanıcı parolası değil makine parolası olduğunu da gösterir. Bu seçenek yalnızca seçenek belirtildiğinde
UnsecuredJoin
geçerlidir. Bu seçenek kullanıldığında, parametreye-Credential
sağlanan kimlik bilgilerinin null kullanıcı adı olmalıdır .JoinWithNewName: Yeni etki alanındaki bilgisayar adını NewName parametresi tarafından belirtilen adla yeniden adlandırır. NewName parametresini kullandığınızda, bu seçenek otomatik olarak ayarlanır. Bu seçenek, Bilgisayarı Yeniden Adlandır cmdlet'iyle kullanılacak şekilde tasarlanmıştır. Bilgisayarı yeniden adlandırmak için cmdlet'ini
Rename-Computer
kullanır, ancak değişikliği etkili hale getirmek için bilgisayarı yeniden başlatmazsanız, bilgisayarı yeni adıyla bir etki alanına eklemek için bu parametreyi kullanabilirsiniz.JoinReadOnly: Bilgisayarı salt okunur bir etki alanı denetleyicisine eklemek için mevcut bir makine hesabını kullanır. Makine hesabının parola çoğaltma ilkesi için izin verilenler listesine eklenmesi ve hesap parolasının birleştirme işleminden önce salt okunur etki alanı denetleyicisine çoğaltılması gerekir.
InstallInvoke: JoinDomainOrWorkgroup yönteminin FJoinOptions parametresinin oluşturma (0x2) ve silme (0x4) bayraklarını ayarlar. JoinDomainOrWorkgroup yöntemi hakkında daha fazla bilgi için bkz. Win32_ComputerSystem sınıfının JoinDomainOrWorkgroup yöntemi. Bu seçenekler hakkında daha fazla bilgi için bkz . NetJoinDomain işlevi.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | JoinOptions |
Kabul edilen değerler: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-OUPath
Etki alanı hesabı için bir kuruluş birimi (OU) belirtir. OU'nun tam ayırt edici adını tırnak içine girin. Varsayılan değer, etki alanındaki makine nesneleri için varsayılan OU'dur.
Tür: | String |
Diğer adlar: | OU |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PassThru
Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, 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
Etki alanına veya çalışma grubuna eklenen bilgisayarları yeniden başlatır. Değişikliğin etkili olması için genellikle yeniden başlatma gerekir.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Server
Bilgisayarı etki alanına ekleyen bir etki alanı denetleyicisinin adını belirtir. Adı DomainName\ComputerName biçiminde girin. Varsayılan olarak, hiçbir etki alanı denetleyicisi belirtilmedi.
Tür: | String |
Diğer adlar: | DC |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UnjoinDomainCredential
Bilgisayarları geçerli etki alanlarından kaldırma izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.
"User01" veya "Domain01\User01" gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential
oluşturulan nesne gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.
Bilgisayarları farklı bir etki alanına taşırken bu parametreyi kullanın. Yeni etki alanına katılma izni olan bir kullanıcı hesabı belirtmek için Credential parametresini kullanın. Uzak bilgisayara bağlanma izni olan bir kullanıcı hesabı belirtmek için LocalCredential parametresini kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | PSCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Unsecure
Belirtilen etki alanına güvenli olmayan bir birleştirme gerçekleştirir.
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ıyorsa 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 |
-WorkgroupName
Bilgisayarların eklendiği çalışma grubunun adını belirtir. Varsayılan değer "WORKGROUP" değeridir.
Tür: | String |
Diğer adlar: | WGN |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Bilgisayar adlarını ve yeni adları Cmdlet'e Add-Computer
yöneltebilirsiniz.
Çıkışlar
PassThru parametresini kullandığınızda, Add-Computer
bir ComputerChangeInfo nesnesi döndürür.
Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.
Notlar
- Windows PowerShell 2.0'da sunucusu mevcut olduğunda bile sunucusu parametresi
Add-Computer
başarısız olur. Windows PowerShell 3.0'da Sunucu parametresinin uygulanması güvenilir bir şekilde çalışması için değiştirilir.
İlişkili Bağlantılar
PowerShell