Aracılığıyla paylaş

Start-DscConfiguration

Modül:
PSDesiredStateConfiguration Module v1.1

Yapılandırmayı düğümlere uygular.

Sözdizimi

ComputerNameAndPathSet EnterprisePublishing 

Start-DscConfiguration
    [[-Path] <String>]
    [[-ComputerName] <String[]>]
    [-Wait]
    [-Force]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimSessionAndPathSet 

Start-DscConfiguration
    [[-Path] <String>]
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-ThrottleLimit <Int32>]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameAndUseExistingSet 

Start-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Wait]
    [-Force]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-UseExisting]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimSessionAndUseExistingSet 

Start-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-ThrottleLimit <Int32>]
    [-UseExisting]
    [-JobName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Start-DscConfiguration cmdlet'i düğümlere yapılandırma 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 İşi nesnesi döndürür. Arka plan işleri hakkında daha fazla bilgi için Get-Help about_Jobsyazın. 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, C:\DSC\Configurations\ yapılandırma ayarlarını bu klasörde ayarları olan her bilgisayara uygular. komutu, dağıtılan her hedef düğüm için job 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, C:\DSC\Configurations\ yerel bilgisayara yapılandırmayı uygular. Komut, 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 ileti 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, New-CimSession cmdlet'ini kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini $Session değişkeninde depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help NewCimSessionyazın.

İkinci komut, C:\DSC\Configurations yapılandırma ayarlarını değişkeninde depolanan $Session nesneleri tarafından tanımlanan bilgisayarlara uygular. Bu örnekte, $Session değişkeni yalnızca Server01 adlı bilgisayar için bir CIM oturumu içerir. komutu yapılandırmayı uygular. Komut, yapılandırılan her bilgisayar için job nesneleri oluşturur.

Parametreler

-CimSession

Cmdlet'i uzak oturumda veya uzak bir bilgisayarda çalıştırır. New-CimSession çıkışı veya Get-CimSession cmdlet'i gibi bir bilgisayar adı veya oturum nesnesi girin. Varsayılan, yerel bilgisayardaki geçerli oturumdur.

Parametre özellikleri

Tür:

CimSession[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

CimSessionAndPathSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Ö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
CimSessionAndUseExistingSet
Position:Named
Zorunlu:True
İşlem hattından gelen değer:True
Ö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

-ComputerName

Bir bilgisayar adı dizisi belirtir. Bu parametre, Yolu parametresinde yapılandırma belgeleri olan bilgisayarları dizide belirtilenlerle kısıtlar.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Çin, SunucuAdı

Parametre kümeleri

ComputerNameAndPathSet
Position:1
Zorunlu:False
İşlem hattından gelen değer:True
Ö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
ComputerNameAndUseExistingSet
Position:1
Zorunlu:False
İşlem hattından gelen değer:True
Ö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

-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

Hedef bilgisayar için PSCredential nesnesi olarak bir kullanıcı adı ve parola belirtir. PSCredential nesnesi edinmek için Get-Credential cmdlet'ini kullanın. Daha fazla bilgi için Get-Help Get-Credentialyazın.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameAndPathSet
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
ComputerNameAndUseExistingSet
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

-Force

Hedef bilgisayarda çalışmakta olan yapılandırma işlemini durdurur ve yeni Start-Configuration işlemini başlatır. Local Configuration Manager'ın RefreshMode özelliği Çekmeolarak ayarlanırsa, bu parametre belirtildiğinde Göndermeolarak değiştirilir.

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

-JobName

İş için kolay bir ad belirtir. Bu parametreyi belirtirseniz, cmdlet bir iş olarak çalışır ve bir İşi nesnesi döndürür.

Varsayılan olarak, Windows PowerShell İşN adını atar; burada N bir tamsayıdır.

Wait parametresini belirtirseniz, bu parametreyi belirtmeyin.

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:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

Yapılandırma ayarları dosyalarını içeren bir 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.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameAndPathSet
Position:0
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
CimSessionAndPathSet
Position:0
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

-ThrottleLimit

cmdlet'ini çalıştırmak için oluşturulabilecek en fazla eşzamanlı işlem sayısını belirtir. Bu parametre atlanırsa veya 0 değeri girilirse, Windows PowerShell bilgisayarda çalışan CIM cmdlet'lerinin sayısına göre cmdlet için en uygun azaltma sınırını hesaplar. Kısıtlama sınırı yalnızca geçerli cmdlet'e uygulanır, oturuma veya bilgisayara uygulanmaz.

Parametre özellikleri

Tür:Int32
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

-UseExisting

Bu cmdlet'in mevcut yapılandırmayı uyguladığını gösterir. Yapılandırma, Start-DscConfiguration kullanılarak veya Publish-DscConfiguration cmdlet'i kullanılarak yayınlanarak hedef bilgisayarda bulunabilir.

Bu cmdlet için bu parametreyi belirtmeden önce Windows PowerShell 5.0'daki Yenilikleriçindeki bilgileri gözden geçirin.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameAndUseExistingSet
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
CimSessionAndUseExistingSet
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

-Wait

Cmdlet'in tüm yapılandırma görevlerini tamamlayana kadar konsolu engellediğini gösterir.

Bu parametreyi belirtirseniz, JobName parametresini belirtmeyin.

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

-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

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.