New-SCSMSubscription
Service Manager'da yeni bir abonelik oluşturur.
Syntax
New-SCSMSubscription
-Class <ManagementPackClass>
[-Condition <Condition>]
[-Description <String>]
[-Criteria <String>]
[-GroupQueue <String[]>]
[-ManagementPack <ManagementPack>]
-DisplayName <String>
-Recipient <EnterpriseManagementObject[]>
-Template <EmailTemplate>
[-PassThru]
[-Enable <Boolean>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-SCSMSubscription cmdlet'i Service Manager bir abonelik oluşturur.
Örnekler
Örnek 1: Abonelik oluşturma
PS C:\>$PrinterClass = Get-SCSMClass -Name "Microsoft.AD.Printer"
PS C:\> $Message = 'Printer $Context/Property[''Type=Windows!Microsoft.AD.Printer'']/PrinterName$ has been updated'
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "ServiceManager.ConfigurationManagement.Configuration"
PS C:\> $Language = [System.Globalization.CultureInfo]"EN"
PS C:\> $Encoding = [System.Text.Encoding]::ASCII
PS C:\> New-SCSMEmailTemplate -Class $PrinterClass -DisplayName "Printer Email Template" -Body $Message -Description "A template for printer notifications" -Encoding $Encoding -Language $Language -ManagementPack $ManagementPack -Subject $Message
PS C:\> $PrinterTemplate = Get-SCSMEmailTemplate -DisplayName "Printer Email Template"
PS C:\> $UserClass = Get-SCSMClass -Name "Microsoft.AD.User"
PS C:\> $Recipient = Get-SCSMClassInstance -Class $UserClass -Filter 'UserName -like "%Administrator"'
PS C:\> New-SCSMSubscription -Class $PrinterClass -DisplayName "Printer update subscription" -Recipient $Recipient -Template $PrinterTemplate -Condition Updated
İlk komut, Get-SCSMClass cmdlet'ini kullanarak Microsoft.AD.Printer adlı bir sınıf alır ve $PrinterClass değişkeninde depolar.
İkinci komut, e-posta için bir ileti oluşturur ve bunu $Message değişkeninde depolar. Bu örnekte, e-postanın konusu ve gövdesiyle aynı dize kullanılır.
Üçüncü komut, Get-SCSMManagementPack cmdlet'ini kullanarak bu şablonun kaydedildiği bir yönetim paketi alır ve $ManagementPack değişkeninde depolar.
Dördüncü ve beşinci komutlar dil ve kodlama değerlerini $Language ve $Encoding değişkenlerinde depolar.
Altıncı komut, yazıcıda değişiklik yapıldığında geçerli olan bir e-posta şablonu oluşturur. komutu, ilk beş komutta oluşturulan değerleri kullanır.
Yedinci komut, Get-SCSMEmailTemplate cmdlet'ini kullanarak Yazıcı Email Şablonu adlı e-posta şablonunu alır ve $PrinterTemplate değişkeninde depolar.
Sekizinci komut Get-SCSMClass kullanarak Microsoft.AD.User adlı sınıfı alır ve $UserClass değişkeninde depolar.
Dokuzuncu komut, Get-SCSMClassInstance cmdlet'ini kullanarak belirtilen filtreyle eşleşen bir ada sahip $UserClass sınıfının bir örneğini alır. Komut bu örneği $Recipient değişkeninde depolar.
Son komut, örneğin önceki bölümlerinde oluşturulan ve yazıcı her güncelleştirildiğinde yöneticiye e-posta gönderen e-posta şablonunu kullanan bir abonelik oluşturur.
Örnek 2: E-posta bildirim aboneliği oluşturma
PS C:\>$Criteria = @'
>> <Criteria>
>> <Expression>
>> <SimpleExpression>
>> <ValueExpression>
>> <Property State="Pre">$Context/Property[Type='Windows!Microsoft.AD.Printer']/Location$</Property>
>> </ValueExpression>
>> <Operator>NotEqual</Operator>
>> <ValueExpression>
>> <Property State="Post">$Context/Property[Type='Windows!Microsoft.AD.Printer']/Location$</Property>
>> </ValueExpression>
>> </SimpleExpression>
>> </Expression>
>> </Criteria>
>> @'
PS C:\> $Recipient = Get-SCSMClassInstance -DisplayName "System.User" -Filter "Name -like 'domain admins'"
PS C:\> $Class = Get-SCSMClass -Displayname "Microsoft.AD.Printer"
PS C:\> $Template = Get-SCSMEmailTemplate -Displayname "StandardEmailTemplate"
PS C:\> New-SCSMSubscription -Class <ManagementPackClass> -DisplayName "A printer subscription" -Recipient $Recipient -Template $Template -Condition Updated -Criteria $Criteria -Description "Changes in the printer location will cause email to be sent"
İlk komut abonelik için bir ölçüt oluşturur ve bunu $Criteria değişkeninde depolar.
İkinci komut, Get-SCSMClassInstance cmdlet'ini kullanarak belirtilen filtreyle eşleşen bir ada sahip System.User adlı sınıfın sınıf örneğini alır. Komut bu örneği $Recipient değişkeninde depolar.
Üçüncü komut Get-SCSMClass kullanarak Microsoft.AD.Printer adlı sınıfı alır ve $Class değişkeninde depolar.
Dördüncü komut, Get-SCSMEmailTemplate kullanarak StandardEmailTemplate adlı e-posta şablonunu alır ve $Template değişkeninde depolar.
Son komut, etki alanı yöneticilerine e-posta göndermek üzere yapılandırılmış bir e-posta bildirim aboneliği oluşturur. Abonelik, konumun değiştiği Yazıcı sınıfındaki değişiklikleri temel alır.
Parametreler
-Class
Aboneliğin hedeflediğini sınıfın adını belirtir. Belirtilen ad, belirtilen e-posta şablonu tarafından başvuruda bulunan aynı sınıfa başvurmalıdır.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
System Center Veri Erişimi hizmetinin çalıştığı bilgisayarın adını belirtir. Credential parametresinde belirtilen kullanıcı hesabının belirtilen bilgisayara erişim hakları olmalıdır.
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Aboneliğin altında çalıştığı koşulu belirtir. Geçerli değerler:
- Oluşturulan
- Güncelleştirildi
- Silindi
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.Condition |
Accepted values: | Created, Updated |
Position: | Named |
Default value: | Updated |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Bu cmdlet'in System Center Veri Erişim hizmetinin çalıştığı sunucuya bağlanmak için kullandığı kimlik bilgilerini belirtir. Belirtilen kullanıcı hesabının bu sunucuya erişim hakları olmalıdır.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Criteria
Aboneliğin kullandığı XML ölçütlerini belirtir. Hem Filter parametresi hem de Ölçüt parametresi belirtilirse, bu cmdlet yalnızca Ölçütleri kullanır.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Aboneliği açıklar.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Aboneliğin görünen adını belirtir.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Bu cmdlet'in aboneliği etkinleştirip etkinleştirmediğini gösterir.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupQueue
Aboneliğin izlediği nesne sayısı üzerinde sınır ayarlamak için bir grup veya kuyruk belirtir.
Type: | System.String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementPack
Bu cmdlet'in aboneliği depoladığı yönetim paketinin adını belirtir.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
Position: | Named |
Default value: | The default management pack |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Bu cmdlet'in oluşturduğu aboneliği döndürdüğünü gösterir. Bu nesneyi diğer cmdlet'lere geçirebilirsiniz.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recipient
Bu aboneliğin e-posta gönderdiği kullanıcıların listesini belirtir.
Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Bir Service Manager yönetim sunucusuna oturumu temsil eden bir nesneyi belirtir.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Template
E-posta şablonunun adını belirtir.
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplate |
Position: | Named |
Default value: | None |
Required: | True |
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: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
None.
Bu cmdlet'e giriş kanalı yapamazsınız.
Çıkışlar
None.
Bu cmdlet herhangi bir çıkış oluşturmaz.