Start-DscConfiguration
Yapılandırmayı düğümlere uygular.
Syntax
Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Start-DscConfiguration Cmdlet, yapılandırmayı düğümlere uygular. UseExisting parametresiyle kullanıldığında, hedef bilgisayarda var olan yapılandırma uygulanır. Bilgisayar adlarını belirterek veya Ortak Bilgi Modeli (CIM) oturumlarını kullanarak yapılandırma uygulamak istediğiniz bilgisayarları belirtin.
Varsayılan olarak, bu cmdlet bir iş oluşturur ve bir İş nesnesi döndürür. Arka plan işleri hakkında daha fazla bilgi için yazın Get-Help about_Jobs. Bu cmdlet'i etkileşimli olarak kullanmak için Wait parametresini belirtin.
Yapılandırma ayarlarını uygularken cmdlet'in ne yaptığının ayrıntılarını görmek için Ayrıntılı parametresini belirtin.
Örnekler
Örnek 1: Yapılandırma ayarlarını uygulama
Start-DscConfiguration -Path "C:\DSC\Configurations\"Bu komut, içindeki yapılandırma ayarlarını C:\DSC\Configurations\ bu klasörde ayarları olan her bilgisayara uygular. komutu, dağıtılan her hedef düğüm için İş nesnelerini döndürür.
Örnek 2: Yapılandırma ayarlarını uygulama ve yapılandırmanın tamamlanmasını bekleme
Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -VerboseBu komut, yapılandırmasını C:\DSC\Configurations\ yerel bilgisayara uygular. komutu, yalnızca yerel bilgisayara dağıtılan her hedef düğüm için İş nesnelerini döndürür. Bu örnek Ayrıntılı parametresini belirtir. Bu nedenle, komut devam ederken konsola iletiler gönderir. Komutu Wait parametresini içerir. Bu nedenle, komut tüm yapılandırma görevlerini tamamlayıncaya kadar konsolunu kullanamazsınız.
Örnek 3: CIM oturumu kullanarak yapılandırma ayarlarını uygulama
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $SessionBu örnek, yapılandırma ayarlarını belirtilen bir bilgisayara uygular. Örnek, cmdlet'iyle kullanmak üzere Server01 adlı bir bilgisayar için bir CIM oturumu oluşturur. Alternatif olarak, cmdlet'i belirtilen birden çok bilgisayara uygulamak için bir CIM oturumları dizisi oluşturun.
İlk komut cmdlet'ini New-CimSession kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini değişkeninde $Session depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help NewCimSession yazın.
İkinci komut, dosyasındaki yapılandırma ayarlarını C:\DSC\Configurations değişkende depolanan CimSession nesneleri tarafından tanımlanan bilgisayarlara $Session uygular. Bu örnekte değişken, $Session yalnızca Server01 adlı bilgisayar için cim oturumu içerir. komutu yapılandırmayı uygular. komutu, yapılandırılan her bilgisayar için İş nesneleri oluşturur.
Parametreler
-CimSession
Cmdlet'i uzak bir oturumda veya uzak bir bilgisayarda çalıştırır. New-CimSession veya Get-CimSession cmdlet'inin çıkışı gibi bir bilgisayar adı veya oturum nesnesi girin. Varsayılan, yerel bilgisayardaki geçerli oturumdur.
| Type: | CimSession[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Bilgisayar adları dizisini belirtir. Bu parametre , Path parametresinde yapılandırma belgeleri olan bilgisayarları dizide belirtilenlerle kısıtlar.
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Hedef bilgisayar için PSCredential nesnesi olarak bir kullanıcı adı ve parola belirtir.
PSCredential nesnesi almak için cmdlet'ini Get-Credential kullanın.
Daha fazla bilgi için Get-Help Get-Credential yazın.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Hedef bilgisayarda çalışmakta olan yapılandırma işlemini durdurur ve yeni Start-Configuration işlemini başlatır. Yerel Configuration Manager RefreshMode özelliği Çekme olarak ayarlanırsa, bu parametre belirtildiğinde Gönder olarak değiştirilir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobName
İş için kolay bir ad belirtir. Bu parametreyi belirtirseniz, cmdlet bir iş olarak çalışır ve bir İş nesnesi döndürür.
Varsayılan olarak, Windows PowerShell jobN adını atar; burada N tamsayıdır.
Wait parametresini belirtirseniz, bu parametreyi belirtmeyin.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Yapılandırma ayarları dosyalarını içeren klasörün dosya yolunu belirtir. Bu cmdlet, bu yapılandırma ayarlarını belirtilen yolda ayar dosyaları olan bilgisayarlara yayımlar ve uygular. Her hedef düğümün şu biçimde bir ayarlar dosyası olmalıdır: <NetBIOS Name>.mof.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottleLimit
Cmdlet'i çalıştırmak için oluşturulabilecek en fazla eşzamanlı işlem sayısını belirtir. Bu parametre atlanırsa veya değeri 0 girilirse, Windows PowerShell bilgisayarda çalışan CIM cmdlet'lerinin sayısına bağlı olarak cmdlet için en uygun kısıtlama sınırını hesaplar. Kısıtlama sınırı yalnızca geçerli cmdlet'e uygulanır, oturuma veya bilgisayara uygulanmaz.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseExisting
Bu cmdlet'in mevcut yapılandırmayı uyguladığını gösterir. Yapılandırma, Publish-DscConfiguration cmdlet'ini kullanarak Start-DscConfiguration veya yayınlayarak hedef bilgisayarda bulunabilir.
Bu cmdlet için bu parametreyi belirtmeden önce Windows PowerShell 5.0 sürümündeki Yenilikler'deki bilgileri gözden geçirin.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Cmdlet'in tüm yapılandırma görevlerini tamamlayana kadar konsolu engellediğini gösterir.
Bu parametreyi belirtirseniz JobName parametresini belirtmeyin.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
İlişkili Bağlantılar
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin