Automatisera och anropa runbooks från SPF

  • Artikel
  • 2 minuter för att läsa

Viktigt

Den här versionen Service Provider Foundation (SPF) har nått slutet av supporten. Vi rekommenderar att du uppgraderar till SPF 2022.

Du kan använda System Center Service Provider Foundation (SPF) och Service Management Automation (SMA) tillsammans för att tillhandahålla automatiserade lösningar för dina klienter. Du kan konfigurera händelser i SPF som SMA-webbtjänsten ska använda.

Automatisera runbooks

Du kan automatisera runbooks med hjälp av SMA, förutsatt att du har konfigurerat SMA för att använda SPF, med hjälp av Set-SCSPFEventRegisration och Get-SCSPFEventRegistation cmdlets. Detta visas i följande exempel:

PS C:\> # This command sets a runbook to be invoked when the Create event for a new virtual machine is raised.  
PS C:\> Set-SCSPFEventRegistration -ResourceName "VMM.VirtualMachine" - ActionName "Create" -RunbookName "Invoke-SampleCmdlet"  
PS C:\>   
PS C:\> # This command gets an event with the Action parameter and stores it in the $event_backup variable.  
PS C:\> $event_backup = Get-SCSPFEventRegistration -Action "Backup"

Anropa runbooks

Du kan ange en runbook i System Center – Orchestrator som ska köras när en ny virtuell dator eller tjänst skapas av fjärranrop till SPF med System Center Virtual Machine Manager (VMM).

  • Du kan ange att runbooken ska anropas med Windows PowerShell T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler.cmdlet.
  • SPF aktiverar interna händelser för att anropa runbooken. Runbooken anropas kontinuerligt så länge den utökningsbara händelsehanteraren är aktiverad.
  • SPF anropar inte runbooken om den virtuella datorn eller tjänsten har skapats på annat sätt. Du kan till exempel Windows PowerShell cmdlets eller använda VMM-konsolen.
  • För att stödja infrastrukturen för att anropa en runbook anropar SPF cmdleten Start-SCOrchestratorRunbook internt. Den behöver inte anropas explicit av användaren.
  • Se till att du har tillämpat följande innan du anropar cmdleten T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler:
    • Url:en för Orchestrator-webbtjänsten.
    • Identitetsinställningarna för SPF-programpoolerna i IIS-hanteraren (Internet Information Services) måste ingå i Orchestrator-användargruppen.

Anropa sedan en runbook på följande sätt:

  1. Anropa T:Microsoft.SystemCenter.Foundation.Cmdlet.Set-SCSPFExtensibleEventHandler med följande parametrar:

    Parameter Värde
    EventName Ange antingen "VirtualMachineCreated" eller "ServiceCreated".
    OrchestratorUri URI:en till Orchestrator-webbtjänsten.
    RunbookPath Den lokala sökvägen till Runbook.
    Aktivera Ange att Runbook ska aktiveras.

    Om du inte vill att Runbook ska anropas utelämnar du den här parametern.

    Exempel:

    PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "http://east.contoso.com:82/Orchestrator2016/Orchestrator.svc" -RunbookPath "\SPF Runbooks\Extensibility\VM Created" -Enable

  2. För att fastställa inställningen för den utökningsbara händelsehanteraren anropar du cmdleten T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler.

  3. Om du vill inaktivera att en runbook anropas upprepar du kommandot T:Microsoft.SystemCenter.Foundation.Cmdlet.Get-SCSPFExtensibleEventHandler, men utan parametern Aktivera . Du kan också ange tomma strängar för parametrarna OrchestratorUrl och Runbookpath , som du ser i följande exempel:

    PS C:\> Set-SCSPFExtensibleEventHandler -EventName "VirtualMachineCreated" -OrchestratorUri "" -RunbookPath ""

Runbook-parametrar

Den här listan med parametrar tillhandahålls automatiskt till runbooken. En runbook behöver inte bearbeta alla parametrar som den tar emot. Den ignorerar parametrar som inte har något syfte i runbooken.

Parametrar för en ny virtuell dator

I följande tabell visas de parametrar som är tillgängliga när en ny virtuell dator skapas. Alla parametrar är valfria om inget annat anges.

Parameter Datatyp
StampId (krävs) GUID
Namn (StampID-namn – krävs) Sträng
CloudId (krävs) GUID
VMTemplateId GUID
HardwareProfileId GUID
VirtualHardDiskId GUID
Description Sträng
CostCenter Sträng
Tagg Sträng
ComputerName Sträng
BlockDynamicOptimization Boolesk
CPULimitForMigration Boolesk
CPULimitFunctionality Boolesk
CPURelativeWeight Int32
DelayStartSeconds Int32
Domain Sträng
Användarnamn Sträng
Lösenord Sträng
DynamicMemoryBufferPercentage Int32
DynamicMemoryEnabled Boolesk
DynamicMemoryMaximumMB Int32
FullName Sträng
Minne Int32
MemoryWeight Int32
OrganizationName Sträng
StartAction Sträng
StartVM Boolesk
StopAction Sträng
CPUCount Byte
Ägare PSObject
ProductKey Sträng
WorkGroup Sträng
TimeZone Int32
RunAsAccountUserName Sträng
LocalAdminRunAsAccountName Sträng
LocalAdminUserName Sträng
LocalAdminPassword Sträng
NewVirtualNetworkAdapterInput PSObject
LinuxAdministratorSSHKey Sträng
LinuxDomainName Sträng

Parametrar för en ny tjänst

I följande tabell visas de parametrar som finns tillgängliga när en ny tjänst skapas. Alla parametrar är valfria om inget annat anges.

Parameter Datatyp
StampID (krävs) GUID
CloudID (krävs) GUID
ServiceTempateId GUID
NewServiceDeployment PSObject
IgnorePlacementErrors Boolesk