Aracılığıyla paylaş

Start-DscConfiguration

  • Başvuru
Modül:
PSDesiredStateConfiguration

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 -Verbose

Bu 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 $Session

Bu ö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