Sdílet prostřednictvím

New-SCSMSubscription

  • Reference
Modul:
System.Center.Service.Manager

Vytvoří nový odběr na portále Service Manager.

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

Rutina New-SCSMSubscription vytvoří odběr v Service Manager.

Příklady

Příklad 1: Vytvoření předplatného

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

První příkaz získá pomocí rutiny Get-SCSMClass třídu s názvem Microsoft.AD.Printer a uloží ji do proměnné $PrinterClass.

Druhý příkaz vytvoří zprávu pro e-mail a uloží ji do proměnné $Message. Tento příklad používá stejný řetězec jako předmět a text e-mailu.

Třetí příkaz získá sadu Management Pack, do které chcete tuto šablonu uložit pomocí rutiny Get-SCSMManagementPack, a pak ji uloží do proměnné $ManagementPack.

Čtvrtý a pátý příkaz ukládají hodnoty jazyka a kódování do $Language a $Encoding proměnných.

Šestý příkaz vytvoří e-mailovou šablonu, která se použije, když dojde ke změně tiskárny. Příkaz používá hodnoty, které byly vytvořeny v prvních pěti příkazech.

Sedmý příkaz získá e-mailovou šablonu s názvem Printer Email Template pomocí rutiny Get-SCSMEmailTemplate a uloží ji do proměnné $PrinterTemplate.

Osmý příkaz získá pomocí rutiny Get-SCSMClass třídu s názvem Microsoft.AD.User a uloží ji do proměnné $UserClass.

Devátý příkaz získá pomocí rutiny Get-SCSMClassInstance instanci třídy v $UserClass, která má název, který odpovídá zadanému filtru. Příkaz uloží instanci do proměnné $Recipient.

Poslední příkaz vytvoří odběr, který používá e-mailovou šablonu vytvořenou dříve v příkladu a která při každé aktualizaci tiskárny odešle e-mail správci.

Příklad 2: Vytvoření odběru e-mailových oznámení

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"

První příkaz vytvoří kritéria pro předplatné a uloží je do proměnné $Criteria.

Druhý příkaz získá instanci třídy s názvem System.User , která má název, který odpovídá zadanému filtru pomocí rutiny Get-SCSMClassInstance. Příkaz uloží instanci do proměnné $Recipient.

Třetí příkaz získá pomocí rutiny Get-SCSMClass třídu s názvem Microsoft.AD.Printer a uloží ji do proměnné $Class.

Čtvrtý příkaz získá e-mailovou šablonu s názvem StandardEmailTemplate pomocí rutiny Get-SCSMEmailTemplate a uloží ji do proměnné $Template.

Poslední příkaz vytvoří odběr e-mailových oznámení, který je nakonfigurovaný tak, aby odesílal e-maily správcům domény. Odběr je založen na změnách ve třídě Tiskárna , kde se změnilo umístění.

Parametry

-Class

Určuje název třídy, na kterou odběr cílí. Zadaný název musí odkazovat na stejnou třídu, na kterou odkazuje zadaná šablona e-mailu.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Určuje název počítače, na kterém běží služba System Center Data Access. Uživatelský účet zadaný v parametru Credential musí mít přístupová práva k zadanému počítači.

Type:System.String[]
Position:Named
Default value:Localhost
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Condition

Určuje podmínku, za které předplatné běží. Platné hodnoty jsou:

  • Vytvořeno
  • Aktualizováno
  • Odstraněné
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

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Určuje přihlašovací údaje, které tato rutina používá pro připojení k serveru, na kterém běží služba System Center Data Access. Zadaný uživatelský účet musí mít přístupová práva k danému serveru.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Criteria

Určuje kritéria XML, která předplatné používá. Pokud je zadán parametr filtru i parametr Kritéria , použije tato rutina pouze kritéria.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Popisuje předplatné.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Určuje zobrazovaný název předplatného.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Určuje, jestli tato rutina povolí odběr.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupQueue

Určuje skupinu nebo frontu pro nastavení limitu počtu objektů, které odběr sleduje.

Type:System.String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPack

Určuje název sady Management Pack, do které tato rutina ukládá předplatné.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Označuje, že tato rutina vrátí předplatné, které vytvoří. Tento objekt můžete předat jiným rutinám.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Recipient

Určuje seznam uživatelů, kterým toto předplatné posílá e-maily.

Type:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Určuje objekt, který představuje relaci k serveru pro správu Service Manager.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Template

Určuje název šablony e-mailu.

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Notifications.EmailTemplate
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None.

Vstup do této rutiny nelze vložit do kanálu.

Výstupy

None.

Tato rutina negeneruje žádný výstup.