Add-Computer

Modül:

Microsoft.PowerShell.Management Module

Yerel bilgisayarı bir etki alanına veya çalışma grubuna ekleyin.

Syntax

Domain (Varsayılan)

Add-Computer
    [-DomainName] <String>
    -Credential <PSCredential>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-UnjoinDomainCredential <PSCredential>]
    [-OUPath <String>]
    [-Server <String>]
    [-Unsecure]
    [-Options <JoinOptions>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Workgroup

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Add-Computer cmdlet'i, 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 Ayrıntılı kullanın ve PassThru parametrelerini .

Ö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, etki alanı denetleyicisini kullanarak Domain01\DC01 yerel bilgisayarı Domain01 etki alanına ekler.

Komutun sonuçları hakkında ayrıntılı bilgi almak için PassThru ve Ayrıntılı 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

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

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 Kimlik Bilgisi 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 Zorla parametresini kullanır.

Örnek 6: Bir bilgisayar grubunu yeni bir etki alanına taşıma

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

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

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

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 Kimlik Bilgisi parametresini kullanır.

Örnek 8: Dosyada listelenen bilgisayarları yeni bir etki alanına ekleme

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Bu komut, dosyada Servers.txt listelenen bilgisayarları Domain02 etki alanına ekler. Win9xUpgrade seçeneğini belirtmek için Seçenekleri 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 Domain03zaten katılmış bir bilgisayardan bir yönetici tarafından çalıştırılmalıdır:

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# 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]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

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.

Örnek 10: Etki alanına yeni bir adla Bilgisayar ekleme

Bu komut bileşimini kullanmak, bilgisayar etki alanına yeni adla katıldığında aynı nesne için birden çok yeniden başlatma ve Active Directory yazma işlemine birden çok yazma işlemi olmasını önler.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

Parametreler

-ComputerName

Bir etki alanına veya çalışma grubuna eklenecek bilgisayarları belirtir. Varsayılan değer 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 Add-Computer parametresini kullanabilirsiniz.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	String[]
Default value:	Local computer
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

Bilgisayarları yeni bir etki alanına ekleme 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 bir nesne gibi Get-Credential 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.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	DomainCredential

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Workgroup

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DomainName

Bilgisayarların eklendiği etki alanını belirtir. Bilgisayarları bir etki alanına eklerken bu parametre gereklidir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	DN, Alan adı

Parametre kümeleri

Domain

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

Kullanıcı onay istemini gizler. Bu parametre olmadan, Add-Computer her bilgisayarın eklenmesini onaylamanızı gerektirir.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LocalCredential

ComputerName parametresi tarafından belirtilen bilgisayarlara 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 bir nesne gibi Get-Credential 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 Kimlik Bilgisi 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.

Parametre özellikleri

Tür:	PSCredential
Default value:	Current user
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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 parametre için kabul edilebilir değerler şunlardır:

• HesapOluştur: Bir etki alanı hesabı oluşturur. Add-Computer cmdlet'i, 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 ayrıca Kimlik Bilgisi (DomainCredential) parametresinin değerinin kullanıcı parolası değil makine parolası olduğunu gösterir. Bu seçenek yalnızca seçenek belirtildiğinde UnsecuredJoin geçerlidir. Bu seçenek kullanıldığında, parametreye -Credentialsağ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, Rename-Computer cmdlet'iyle kullanılacak şekilde tasarlanmıştır. Bilgisayarı yeniden adlandırmak için Rename-Computer cmdlet'ini kullanıyorsanız, ancak değişikliğin etkili olması için bilgisayarı yeniden başlatmıyorsanı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.

Parametre özellikleri

Tür:	JoinOptions
Default value:	None
Kabul edilen değerler:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	OU

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Server

Bilgisayarı etki alanına ekleyen bir etki alanı denetleyicisinin adını belirtir. Adı FQDN biçiminde girin. Varsayılan olarak, hiçbir etki alanı denetleyicisi belirtilmedi.

Ağustos 2024'te başlayarak, etki alanına katılım için güvenlik sağlamlaştırma, etki alanı denetleyicisinin FQDN'sini kullanmanızı gerektirir. Örneğin: DC1.contoso.com. Daha fazla bilgi için bkz . NetJoin Etki Alanına Katılma Sağlamlaştırma Değişiklikleri.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	DC

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UnjoinDomainCredential

Bilgisayarları geçerli etki alanlarından kaldırma 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 bir nesne gibi Get-Credential 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 Kimlik Bilgisi 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.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Unsecure

Belirtilen etki alanına güvenli olmayan bir birleştirme gerçekleştirir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Domain

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WorkgroupName

Bilgisayarların eklendiği çalışma grubunun adını belirtir. Varsayılan değer "WORKGROUP" değeridir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	WGN

Parametre kümeleri

Workgroup

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Bilgisayar adlarını ve yeni adları Add-Computer Cmdlet'ine yöneltebilirsiniz.

Çıkışlar

ComputerChangeInfo

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, Add-Computer parametresi, sunucu mevcut olduğunda bile başarısız olur. Windows PowerShell 3.0'da, Server parametresinin uygulanması güvenilir bir şekilde çalışması için değiştirilir.

İlişkili Bağlantılar

• Denetim Noktası-Bilgisayar
• Bilgisayarı Kaldır
• Bilgisayarı Yeniden Başlat
• Bilgisayarı-Yeniden-Adlandır
• Bilgisayarı Geri Yükle
• Bilgisayarı Durdur
• Bağlantı Test Et