Configuration Manager cmdlet 'lerini kullanmaya başlayın

  • Makale

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.

Not

geçerli dalın Configuration Manager desteklenen tüm sürümleri Windows PowerShell sürüm 5,1 ' dir. PowerShell sürüm 7 ' yi zaten yüklediyseniz, PowerShell sürüm 5,1 ' i kullanmaya devam edebilirsiniz. daha fazla bilgi için, bkz. Windows PowerShell 5,1 ile PowerShell 7 yan yana kullanımı.

Sürüm 2010 ' den başlayarak PowerShell cmdlet kitaplığı Configuration Manager PowerShell 7 ' yi destekler. Daha fazla bilgi için bkz. PowerShell sürüm 7 desteği.

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.

Önemli

Güncelleştirilebilir içeriğin sürüm 2103 sürümü ile yapılandırılması ve yayımlanmasıyla ilgili bir değişiklik nedeniyle, sürüm 2010 sitesinde Update-Help kullanmayın. Siteyi 2103 sürümüne güncelleştirin ve ardından yerel yardım içeriğini güncelleştirin.

Daha fazla bilgi için bkz. PowerShell sürüm 2103 sürüm notları.

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.

İpucu

PowerShell 7, olarak çalışır pwsh.exe . PowerShell 'in önceki sürümleri farklı çalıştır powershell.exe .

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