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.
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.
PowerShell 'i açmak için en kolay yöntem Configuration Manager konsolundan doğrudan olur.
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.
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:\>
Ç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 modülünü el ile yükleyerek mevcut bir Windows PowerShell oturumundan Configuration Manager Bağlan.
Başlat menüsü bir Windows PowerShell oturumu açın.
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.
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.
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:
PowerShell 'in, Get-CMSite cmdlet 'ini kullanarak Configuration Manager modülünü doğru şekilde yüklendiğini onaylayın.
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!.
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.
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
.
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 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.
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
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.
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.