Configuration Manager cmdlet 'lerini kullanmaya başlayın

Uygulama hedefi: Configuration Manager (geçerli dal)

Configuration Manager hiyerarşinizi yönetmek için Windows PowerShell kullanın. WMI ve C# kullanarak diğer belgelenen yaklaşımlara benzer Configuration Manager otomatikleştirecek veya genişletebileceğiniz PowerShell betiklerini kullanabilirsiniz. Daha fazla bilgi için bkz. SDK Configuration Manager.

PowerShell 'de Configuration Manager konsolundan veya bir Windows PowerShell oturumundan Configuration Manager cmdlet 'leri ve betikleri çalıştırın. Configuration Manager konsolunu kullanarak Configuration Manager cmdlet 'leri çalıştırdığınızda oturumunuz otomatik olarak site bağlamında çalışır.

Sürüm 2103 ' den başlayarak, ConfigurationManager PowerShell modülü Microsoft .NET sürüm 4.7.2 veya üstünü gerektirir.

Configuration Manager konsolundan PowerShell

PowerShell 'i açmak için en kolay yöntem Configuration Manager konsolundan doğrudan olur.

1. Configuration Manager konsolunu başlatın. Sol üst köşede mavi bir dikdörtgen vardır. mavi dikdörtgendeki beyaz oku seçin ve Windows PowerShell üzerinden Bağlan seçin.

2. Windows PowerShell yüklendikten sonra, site kodunuzu içeren bir istem görürsünüz. Örneğin, site kodu "ABC" ise, istem şöyle görünür: PS ABC:\>

3. Çalıştığını doğrulamak için Get-CMSite cmdlet 'ini kullanın. Bu cmdlet, şu anda bağlı olduğunuz Configuration Manager sitesi ve tüm alt siteler hakkındaki bilgileri döndürür. Örneğin, site sunucusu adı, yükleme Direktörü, site adı ve sürüm.

Configuration Manager PowerShell modülünü içeri aktarma

Configuration Manager modülünü el ile yükleyerek mevcut bir Windows PowerShell oturumundan Configuration Manager Bağlan.

1. Başlat menüsü bir Windows PowerShell oturumu açın.

2. Import-Module cmdlet 'ini kullanarak Configuration Manager modülünü içeri aktarın. Configuration Manager modülünün yolunu belirtin veya modülünü içeren dizine geçin. Varsayılan olarak, modül aşağıdaki yoldur: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1

   Önemli

   Bu yol, sürüm 1910 ' den başlayarak klasörü kullanmak için değişti Microsoft Endpoint Manager . Modülün başka bir klasörde mevcut olabilecek eski bir sürümünü içeri aktardığınızdan emin olun. Modülünü içeri aktardıktan sonra modül sürümünü ve yolunu denetlemek için aşağıdaki komutları kullanın:

   (Get-Module -Name ConfigurationManager).Version
   (Get-Module -Name ConfigurationManager).Path
   

   Aşağıdaki örnek modülün dizinine geçer ve ardından içeri aktarır:

   Set-Location 'C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin'
   Import-Module .\ConfigurationManager.psd1
   

   İpucu

   SMS_ADMIN_UI_PATH ortam değişkenini de kullanabilirsiniz. Örneğin:

   Set-Location "$env:SMS_ADMIN_UI_PATH\..\"
   

   Ayrıca, set-location cmdlet 'i yerine dizinleri değiştirmek için CD diğer adını da kullanabilirsiniz.

3. Bu bilgisayarda Configuration Manager modülünü ilk kez içeri aktardıysanız, site sürücüsünü oluşturmanız gerekebilir. Örneğin:

   New-PSDrive -Name "ABC" -PSProvider "AdminUI.PS.Provider\CMSite" -Root "siteserver.contoso.com" -Description "Primary site"
   

   İpucu

   PowerShell 'i konsolundan başlattığınızda, o anda bağlı olan siteye yönelik bir kolaylık olarak PSDrive otomatik olarak oluşturulur. Bir hiyerarşiniz varsa, her site için sürücü oluşturmak üzere New-PSDrive ' ı kullanın.

4. Configuration Manager cmdlet 'lerini çalıştırmak için, yolu Configuration Manager sitesine geçmeniz gerekir. Aşağıdaki örnekte, site kodu ABC :

   Set-Location ABC:
   

5. PowerShell 'in, Get-CMSite cmdlet 'ini kullanarak Configuration Manager modülünü doğru şekilde yüklendiğini onaylayın.

Güncelleştirme yardımı

Sürüm 2010 ' den başlayarak Configuration Manager PowerShell modülüyle ilgili en son bilgileri almak için Update-Help cmdlet 'ini kullanın. Bu içerik, ConfigurationManager modülüiçin docs.Microsoft.com 'de yayımlandıklarınız ile aynıdır.

Bu cmdlet 'i çalıştırdığınız bilgisayar, özellikle internet erişimi gerektirir pshelpprod.blob.core.windows.net . Ardından, yükseltilmiş bir PowerShell oturumunda aşağıdaki komutu çalıştırın:

Update-Help -Module ConfigurationManager

Configuration Manager cmdlet yardımını güncelleştirdikten sonra Get-Help cmdlet 'ini kullanarak cmdlet 'lerle ilgili yardım alabilirsiniz. Örneğin:

Get-Help Get-CMDevice
Get-Help Get-CMDevice -Examples
Get-Help Get-CMDevice -Parameter *

Daha fazla bilgi için şu PowerShell blog gönderisine bakın: size yardım aldınız!.

Ortak Parametreler

Tüm Configuration Manager cmdlet 'leri ortak PowerShell parametrelerini destekler:

• Hata Ayıklama
• ErrorAction
• ErrorVariable
• Informationaction
• Informationvariable
• OutVariable
• OutBuffer
• PipelineVariable
• Ayrıntılı
• WarningAction
• WarningVariable

Daha fazla bilgi için bkz. about_CommonParameters.

PowerShell sürüm 7 desteği

Sürüm 2010 ' den başlayarak, PowerShell cmdlet kitaplığı Configuration Manager PowerShell sürüm 7 ' yi destekler. PowerShell 7 hakkında daha fazla bilgi için, indirme ve yükleme yönergeleri dahil, bkz. Windows PowerShell 'ı yükleme.

PowerShell sürüm 7 ' yi desteklemeyen cmdlet 'ler

Aşağıdaki cmdlet 'ler PowerShell 7 ' yi desteklemez:

• Import-CMPackage
• Import-CMDriverPackage
• Import-CMTaskSequence
• Export-CMPackage
• Export-CMDriverPackage
• Export-CMTaskSequence

.net Core yerine, PowerShell sürüm 7 ile kullanılan .NET Framework gerekir.

Sürüm 2103 ' den başlayarak, bu cmdlet 'leri bir PowerShell sürüm 7 oturumunda kullanmayı denerseniz, şu hatayla başarısız olur: This cmdlet only supports the ".NET Framework" runtime.

PowerShell sürüm 7 ile ilgili bilinen sorunlar

• PowerShell 7 ' yi doğrudan Configuration Manager konsolundan çalıştıramazsınız. PowerShell 7 ' yi el ile başlatın ve Configuration Manager modülünü içeri aktarın.

• Geçerli destek yalnızca Configuration Manager cmdlet 'leri içindir. PowerShell 'i kullanan Configuration Manager diğer özellikleri sürüm 7 ' yi desteklemiyor olabilir. Örneğin, betikleri, CMPivotveya PowerShell Betiği Çalıştır görev dizisi adımını çalıştırın.

PowerShell için geri bildirim

Configuration Manager PowerShell cmdlet 'leri hakkında geri bildiriminiz varsa, geri bildirim göndermek için Configuration Manager konsolundaki aynı seçenekleri kullanın. Daha fazla bilgi için bkz. ürün geri bildirimi.

Kaş çatma gönderdiğinizde, PowerShell 'e özgü aşağıdaki ek bilgileri ekleyin:

• Microsoft 'un sorunu yeniden oluşturmaya çalışabilmesi için kullandığınız tam betik veya komut söz dizimi.

• Gerçek davranışa kıyasla beklediğiniz davranış.

• Ayrıntılı ortak parametresiyle çalıştırdığınızda tam çıkış.

• ConfigurationManager modülünün sürümü ve yolu. Örneğin, aşağıdaki komutların çıkışını ekleyin:

  (Get-Module -Name ConfigurationManager).Version
  (Get-Module -Name ConfigurationManager).Path
  

• Bir cmdlet hata döndürürse, özel durum ayrıntılarını almak için aşağıdaki komutu kullanın:

  $Error[0].Exception | Format-List * -Force
  

Önizleme sürüm notları

Temel belge kitaplığının teknik önizleme özellikleri makalesi, PowerShell için sürüm notlarını içerir. Örneğin, bkz. Technical preview version 2106.

Sonraki adımlar

En son sürümde yapılanlar hakkında daha fazla bilgi Yapılandırma Yöneticisi içindekiler tablosundan en son Sürüm Notları'ı seçin.

Tek tek cmdlet'ler hakkında daha fazla bilgi için Yapılandırma Yöneticisi cmdlet başvurusuna bakın.

Öğrenme ve Windows PowerShell hakkında daha fazla bilgi için bkz. PowerShell 101.