Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Globální prostředky jsou k dispozici pro všechny runbooky v prostředí Automation. Vytvoříte a nakonfigurujete je pomocí pracovního prostoru Automation na portálu pro správu nebo s příslušnými rutinami ve Windows PowerShellu. V runbooku můžete načíst a nastavit hodnoty pro globální prostředí pomocí aktivit v modulu RunbookConstructs. Cmdlety Windows PowerShellu jsou k dispozici pro použití v runboocích ve službě Service Management Automation, ale doporučují se spíše aktivity, protože jsou efektivnější, jelikož nemusí pracovat prostřednictvím webové služby Automation.
Získání nebo nastavení přihlašovacích údajů
Přihlašovací údaje služby Automation jsou uživatelské jméno a heslo, které lze použít s příkazy Windows PowerShellu nebo certifikátem, který se nahraje na server. Vlastnosti přihlašovacích údajů jsou bezpečně uložené v databázi Automation a dají se k němu přistupovat v runbooku pomocí aktivity Get-AutomationPSCredential nebo Get-AutomationCertificate .
PowerShell pro správu přihlašovacích údajů
Cmdlety uvedené v následující tabulce lze použít k vytváření a správě přihlašovacích údajů pomocí prostředí Windows PowerShell v rámci nástroje Service Management Automation.
| Cmdlety | Popis |
|---|---|
| Získej-SmaCertifikát | Načte certifikát automatizace. |
| Get-SmaCredential | Načte přihlašovací údaje PowerShellu pro automatizaci. |
| Remove-SmaCertificate | Odebere automatizační certifikát. |
| Remove-SmaCredential | Odebere přihlašovací údaje PowerShellu pro automatizaci. |
| Set-SmaCertificate | Vytvoří nový certifikát nebo nastaví vlastnosti existujícího certifikátu, včetně nahrání souboru certifikátu a nastavení hesla pro soubor .pfx. |
| Set-SmaCredential | Vytvoří nové přihlašovací údaje PowerShellu pro automatizaci nebo nastaví vlastnosti pro existující přihlašovací údaje. |
PowerShell pro práci s přihlašovacími údaji
Aktivity v následující tabulce můžete použít pro přístup k přihlašovacím údajům v runbooku.
| Aktivity | Popis |
|---|---|
| Get-AutomationCertificate | Získá certifikát pro použití v příručce. |
| Get-AutomationPSCredential | Získá uživatelské jméno a heslo pro použití v runbooku. |
Poznámka:
Měli byste se vyhnout použití proměnných v parametru Name příkazů Get-AutomationPSCredential a Get-AutomationCertificate, protože to může komplikovat zjišťování závislostí mezi runbooky a proměnnými automatizace.
Vytvoření přihlašovacích údajů PowerShellu na portálu pro správu
Vyberte pracovní prostor Automation.
V horní části okna vyberte Prostředky.
V dolní části okna vyberte Přidat nastavení.
Vyberte Přidat přihlašovací údaje.
V rozevíracím seznamu Typ přihlašovacích údajů vyberte Přihlašovací údaje PowerShell.
Do pole Název zadejte název přihlašovacích údajů.
Vyberte šipku vpravo.
Zadejte hodnoty pro každou vlastnost.
Pro uložení přihlašovacích údajů vyberte symbol zaškrtnutí.
Vytvoření certifikátu v nástroji
Portál pro správu
Vyberte pracovní prostor Automation.
V horní části okna vyberte Prostředky.
V dolní části okna vyberte Přidat nastavení.
Vyberte Přidat přihlašovací údaje.
V rozevíracím seznamu Typ přihlašovacích údajů vyberte Certifikát.
Do pole Název zadejte název certifikátu.
Vyberte šipku vpravo.
Vyberte Procházet soubor a přejděte do souboru .cer nebo .pfx.
Pokud jste vybrali soubor .pfx, zadejte jeho heslo.
Vyberte značku zaškrtnutí a uložte certifikát.
Vytvoření přihlašovacích údajů pomocí PowerShellu
Následující ukázkové příkazy ukazují, jak vytvořit nové přihlašovací údaje.
$webServer = 'https://MyWebServer'
$port = 9090
$credName = 'MyCredential'
$user = 'contoso\MyUser'
$pwd = ConvertTo-SecureString -String 'P@$$w0rd' -AsPlainText -Force
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $user,$pwd
Set-SmaCredential -WebServiceEndpoint $webServer -port $port -Name $credName -Value $cred
Vytvoření nového certifikátu PowerShellu pomocí Windows PowerShellu ve službě Service Management Automation
Následující ukázkové příkazy ukazují, jak vytvořit nový certifikát importem souboru certifikátu.
$webServer = 'https://MyWebServer'
$port = 9090
$certName = 'MyCertificate'
$path = 'c:\certs\MyCertificate.pfx'
$certPwd = ConvertTo-SecureString -String 'P@$$w0rd' -AsPlainText -Force
Set-SmaCertificate -WebServiceEndpoint $webServer -port $port -Name $certName -Path $certPath -Password $certPwd
Použití přihlašovacích údajů PowerShellu v runbooku
Přihlašovací údaje PowerShell načtete pomocí aktivity Get-AutomationPSCredential v runbooku. Tím se vrátí objekt PSCredential, který můžete použít v pracovním postupu.
Následující ukázkové příkazy ukazují, jak používat přihlašovací údaje PowerShellu v runbooku. V tomto příkladu se přihlašovací údaje používají s aktivitou InlineScript ke spuštění sady příkazů pomocí alternativních přihlašovacích údajů.
$myCredential = Get-AutomationPSCredential -Name 'MyCredential' InlineScript { <Commands> } -PSComputerName $ServerName -PSCredential $myCredential
Správa připojení SMA
Automatizační spojení obsahuje nezbytné informace pro připojení ke službě nebo aplikaci z runbooku. Tyto informace jsou definovány v modulu pro aplikaci a obvykle obsahují takové informace, jako je uživatelské jméno a heslo a počítač pro připojení. Můžou být vyžadovány i další informace, jako je certifikát nebo ID předplatného. Vlastnosti připojení jsou bezpečně uložené v databázi Automation a dají se k němu přistupovat v runbooku pomocí aktivity Get-AutomationConnection .
Windows PowerShell cmdlety
Přihlašovací údaje můžete vytvářet a spravovat pomocí rutin prostředí Windows PowerShell v následující tabulce.
| Cmdlety | Popis |
|---|---|
| Get-SmaConnection | Načte hodnoty pro každé pole v určitém připojení. |
| Get-SmaConnectionField | Načte definice polí pro konkrétní typ připojení. |
| Získat typ připojení SMA | Načte dostupné typy připojení. |
| New-SmaConnection | Vytvoří nové připojení. |
| Remove-SmaConnection | Odeberte existující připojení. |
| Set-SmaConnectionFieldValue | Nastaví hodnotu konkrétního pole pro existující připojení. |
Aktivity v runbookách
K připojenímům v runbooku můžete přistupovat pomocí aktivit uvedených v následující tabulce.
| Aktivity | Popis |
|---|---|
| Get-AutomationConnection | Získá připojení pro použití v runbooku. |
Vytvoření připojení na portálu pro správu
Vyberte pracovní prostor Automation.
V horní části okna vyberte Prostředky.
V dolní části okna vyberte Přidat nastavení.
Vyberte Přidat připojení.
V rozevíracím seznamu Typ připojení vyberte typ připojení.
Do pole Název zadejte název připojení.
Vyberte šipku vpravo.
Zadejte hodnotu pro každou vlastnost.
Klikněte na značku zaškrtnutí pro uložení připojení.
Vytvoření připojení pomocí Windows PowerShellu
Následující ukázkové příkazy vytvoří nové připojení nástroje Virtual Machine Manager s názvem MyVMMConnection.
Poznámka:
K definování vlastností připojení používáme tabulku hash. Důvodem je to, že různé typy připojení vyžadují různé sady vlastností. Připojení jiného typu by používalo jinou sadu hodnot polí.
Další informace o tabulkách hash najdete v tématu about_Hash_Tables.
$webServer = 'https://MyWebServer'
$port = 9090
$connectionName = 'MyConnection'
$fieldValues = @{"Username"="MyUser";"Password"="password";"ComputerName"="MyComputer"}
New-SmaConnection -WebServiceEndpoint $webServer -port $port -Name $connectionName -ConnectionTypeName "VirtualMachineManager" -ConnectionFieldValues $fieldValues
Použití připojení v runbooku
Použijte připojení v runbooku pomocí aktivity Get-AutomationConnection. Tato aktivita načte hodnoty různých polí v připojení a vrátí je jako tabulku hash, která se pak dá použít s příslušnými příkazy v runbooku.
Další informace o tabulkách hash najdete v tématu about_Hash_Tables.
Následující ukázkový kód ukazuje, jak pomocí připojení zadat název počítače a přihlašovací údaje pro blok InlineScript , který spouští příkazy na jiném počítači.
$con = Get-AutomationConnection -Name 'MyConnection'
$securepassword = ConvertTo-SecureString -AsPlainText -String $con.Password -Force
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $con.Username, $securepassword
InlineScript {
<Commands>
} -PSComputerName $con.ComputerName -PSCredential $cred
Zjednodušte vývoj runbooků pomocí globálních proměnných
Proměnné automatizace jsou hodnoty, které jsou k dispozici pro všechny runbooky. Můžete je vytvářet, upravovat a načítat z portálu pro správu, Windows PowerShellu nebo z runbooku. Proměnné automatizace jsou užitečné pro následující scénáře:
Sdílejte hodnotu mezi více provozně-technickými manuály.
Sdílejte hodnotu mezi více úlohami ze stejného plánovače úloh.
Spravujte hodnotu z portálu pro správu nebo z příkazového řádku Windows PowerShellu, který používají runbooky.
Proměnné automatizace jsou uchovávány, aby byly stále dostupné, i když runbook selže. Toto rovněž umožňuje nastavit hodnotu jedním runbookem, která je následně použita jiným runbookem, nebo stejným runbookem při jeho dalším spuštění.
Při vytvoření proměnné je nutné zadat jeho datový typ z následujícího seznamu. To znamená, že portál pro správu může zobrazit příslušný ovládací prvek pro hodnotu proměnné. Proměnné můžete přiřadit pouze hodnotu správného typu.
Řetězec
Celé číslo
Boolovská hodnota
Datum a čas
Při vytvoření proměnné můžete určit, že se uloží zašifrovaná. Když je proměnná zašifrovaná, je bezpečně uložená v databázi SMA a její hodnota se nedá načíst z rutiny Get-SmaVariable . Jediný způsob, jak lze načíst zašifrovanou hodnotu, je z aktivity Get-AutomationVariable v runbooku. Vytvořením tabulky hash můžete uložit více hodnot definovaného typu do jedné proměnné.
Windows PowerShell cmdlety
Proměnné můžete vytvářet a spravovat pomocí rutin Prostředí Windows PowerShell v následující tabulce.
| Cmdlety | Popis |
|---|---|
| Get-SmaVariable | Načte hodnotu existující proměnné. |
| Set-SmaVariable | Vytvoří novou proměnnou nebo nastaví hodnotu pro existující proměnnou. |
Aktivity v runbookách
K proměnným v runbooku můžete přistupovat pomocí aktivit v následující tabulce.
| Aktivity | Popis |
|---|---|
| Get-AutomationVariable | Načte hodnotu existující proměnné. |
| Set-AutomationVariable | Nastaví hodnotu existující proměnné. |
Poznámka:
Měli byste se vyhnout použití proměnných v parametru Name Get-AutomationVariable, protože to může komplikovat zjišťování závislostí mezi runbooky a proměnnými Automation.
Vytvoření nové proměnné na portálu pro správu
Vyberte pracovní prostor Automation.
V horní části okna vyberte Prostředky.
V dolní části okna vyberte Přidat nastavení.
Vyberte Přidat proměnnou.
V rozevíracím seznamu Typ vyberte datový typ.
Do pole Název zadejte název proměnné.
Vyberte šipku vpravo.
Zadejte hodnotu proměnné a určete, jestli se má zašifrovat.
Vyberte značku zaškrtnutí a uložte novou proměnnou.
Vytvoření nové proměnné pomocí Windows PowerShellu
Rutina Set-SmaVariable vytvoří novou proměnnou a nastaví hodnotu existující proměnné. Následující ukázkové příkazy ukazují, jak vytvořit proměnnou typu řetězec.
$web = 'https://MySMAServer'
$port = 9090
Set-SMAVariable -WebServiceEndpoint $web -Port $port -Name 'MyVariable' -Value 'My String'
Použijte proměnnou v runbooku
Následující ukázkový kód ukazuje, jak nastavit a načíst proměnnou v runbooku. V této ukázce se předpokládá, že již byly vytvořeny proměnné typu integer s názvem NumberOfIterations a NumberOfRunnings a proměnná řetězce typu s názvem SampleMessage.
$NumberOfIterations = Get-AutomationVariable -Name 'NumberOfIterations' $NumberOfRunnings = Get-AutomationVariable -Name 'NumberOfRunnings' $SampleMessage = Get-AutomationVariable -Name 'SampleMessage' Write-Output "Runbook has been run $NumberOfRunnings times." for ($i = 1; $i -le $NumberOfIterations; $i++) { Write-Output "$i`: $SampleMessage" } Set-AutomationVariable -Name NumberOfRunnings -Value (NumberOfRunnings += 1)
Další kroky
- Přečtěte si o vytváření modulu integrace.
- Přečtěte si o vytváření runbooků pro automatizaci.