New-SCSMSubscription

Создает новую подписку в Service Manager.

Синтаксис

Default (по умолчанию)

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

Описание

Командлет New-SCSMSubscription создает подписку в Service Manager.

Примеры

Пример 1. Создание подписки

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

Первая команда получает класс с именем Microsoft.AD.Printer с помощью командлета Get-SCSMClass, а затем сохраняет его в переменной $PrinterClass.

Вторая команда создает сообщение для электронной почты и сохраняет его в переменной $Message. В этом примере используется та же строка, что и тема и текст сообщения электронной почты.

Третья команда получает пакет управления, в котором нужно сохранить этот шаблон с помощью командлета Get-SCSMManagementPack, а затем сохраняет его в переменной $ManagementPack.

Четвертые и пятые команды хранят значения для языка и кодирования в переменных $Language и $Encoding.

Шестая команда создает шаблон электронной почты, который применяется при изменении принтера. Команда использует значения, созданные в первых пяти командах.

Седьмая команда получает шаблон электронной почты с именем "Шаблон электронной почты принтера" с помощью командлета Get-SCSMEmailTemplate, а затем сохраняет его в переменной $PrinterTemplate.

Восьмая команда получает класс с именем Microsoft.AD.User с помощью Get-SCSMClass, а затем сохраняет его в переменной $UserClass.

Девятая команда получает экземпляр класса в $UserClass с именем, соответствующим указанному фильтру с помощью командлета Get-SCSMClassInstance. Команда сохраняет этот экземпляр в переменной $Recipient.

Последняя команда создает подписку, использующую шаблон электронной почты, созданную ранее в примере, которая отправляет администратору сообщение электронной почты при обновлении принтера.

Пример 2. Создание подписки на уведомление по электронной почте

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"

Первая команда создает условия для подписки и сохраняет ее в переменной $Criteria.

Вторая команда получает экземпляр класса для класса с именем System.User с именем, соответствующим указанному фильтру, с помощью командлета Get-SCSMClassInstance. Команда сохраняет этот экземпляр в переменной $Recipient.

Третья команда получает класс с именем Microsoft.AD.Printer с помощью Get-SCSMClass, а затем сохраняет его в переменной $Class.

Четвертая команда получает шаблон электронной почты standardEmailTemplate с помощью Get-SCSMEmailTemplate, а затем сохраняет его в переменной $Template.

Последняя команда создает подписку на уведомление электронной почты, настроенную для отправки электронной почты администраторам домена. Подписка основана на изменениях в классе принтера , где расположение изменилось.

Параметры

-Class

Указывает имя класса, предназначенного для подписки. Указанное имя должно ссылаться на тот же класс, на который ссылается указанный шаблон электронной почты.

Свойства параметра

Тип:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ComputerName

Указывает имя компьютера, на котором выполняется служба доступа к данным System Center. Учетная запись пользователя, указанная в параметре учетных данных , должна иметь права доступа к указанному компьютеру.

Свойства параметра

Тип:

System.String[]

Default value:Localhost
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Condition

Указывает условие, в котором выполняется подписка. Допустимые значения:

  • Созданный
  • Обновлено
  • Уничтоженный

Свойства параметра

Тип:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.Condition
Default value:Updated
Допустимые значения:Created, Updated
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Credential

Указывает учетные данные, которые этот командлет использует для подключения к серверу, на котором выполняется служба доступа к данным System Center. Указанная учетная запись пользователя должна иметь права доступа к серверу.

Свойства параметра

Тип:System.Management.Automation.PSCredential
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Criteria

Указывает XML-критерии, которые использует подписка. Если указан параметр фильтра и параметр Условий, этот командлет использует только условия.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Описывает подписку.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisplayName

Указывает отображаемое имя подписки.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Enable

Указывает, включает ли этот командлет подписку.

Свойства параметра

Тип:System.Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupQueue

Указывает группу или очередь, чтобы задать ограничение на количество объектов, отслеживаемых подпиской.

Свойства параметра

Тип:

System.String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ManagementPack

Указывает имя пакета управления, в котором этот командлет хранит подписку.

Свойства параметра

Тип:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Default value:The default management pack
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PassThru

Указывает, что этот командлет возвращает созданную подписку. Этот объект можно передать другим командлетам.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Recipient

Указывает список пользователей, которым эта подписка отправляет электронную почту.

Свойства параметра

Тип:

Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SCSession

Указывает объект, представляющий сеанс на сервере управления Service Manager.

Свойства параметра

Тип:

Microsoft.SystemCenter.Core.Connection.Connection[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Template

Указывает имя шаблона электронной почты.

Свойства параметра

Тип:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplate
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None.

Входные данные в этот командлет невозможно передать.

Выходные данные

None.

Этот командлет не создает выходные данные.