Verbindingen
Gepubliceerd: juni 2016
Van toepassing op: Windows Azure Pack for Windows Server, System Center 2012 R2 Orchestrator
Een Automatisering-verbinding bevat de informatie die nodig is om vanuit een runbook verbinding te maken met een service of toepassing. Deze informatie is gedefinieerd in de module voor de toepassing en omvat doorgaans gegevens zoals de gebruikersnaam en het wachtwoord en de computer waarmee verbinding moet worden gemaakt. Mogelijk is ook andere informatie vereist zoals een certificaat of een abonnement-id. De eigenschappen van een verbinding worden veilig opgeslagen in de Automatisering-database en kunnen in het runbook worden geopend met de activiteit Get-AutomationConnection.
Windows PowerShell-cmdlets
De cmdlets in de volgende tabel worden gebruikt voor het maken en beheren van referenties met Windows PowerShell in Automatisering van servicebeheer.
Cmdlets |
Beschrijving |
---|---|
Hiermee haalt u de waarden voor elk veld in een bepaalde verbinding op. |
|
Hiermee haalt u de velddefinities voor een bepaald verbindingstype op. |
|
Hiermee haalt u de beschikbare verbindingstypen op. |
|
Hiermee maakt u een nieuwe verbinding. |
|
Hiermee verwijdert u een bestaande verbinding. |
|
Hiermee stelt u de waarde van een bepaald veld voor een bestaande verbinding in. |
Runbookactiviteiten
De activiteiten in de volgende tabel worden gebruikt voor toegang tot verbindingen in een runbook.
Activiteiten |
Beschrijving |
---|---|
Get-AutomationConnection |
Hiermee haalt u een verbinding op die moet worden gebruikt in een runbook. |
Een nieuwe verbinding maken
Een nieuwe verbinding maken met de beheerportal
Selecteer de werkruimte Automation.
Klik aan de bovenkant van het venster op Activa.
Klik aan de onderkant van het venster op Instelling toevoegen.
Klik op Verbinding toevoegen.
In de vervolgkeuzelijst Type verbinding selecteert u een verbindingstype.
Typ een naam voor de verbinding in het vak Naam.
Klik op de pijl-rechts.
Typ een waarde voor elke eigenschap.
Klik op het vinkje om de verbinding op te slaan.
Een nieuwe verbinding maken met Windows PowerShell in Service Management Automation
Met de volgende voorbeeldopdrachten wordt een nieuwe Virtual Machine Manager-verbinding met de naam MyVMMConnection gemaakt. We gebruiken een hashtabel voor het definiëren van de eigenschappen van de verbinding. Dit komt doordat voor verschillende verbindingstypen verschillende sets van eigenschappen nodig zijn. Een ander type verbinding gebruikt een andere set veldwaarden.
Zie about_Hash_Tables voor meer informatie over hashtabellen.
$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
Een verbinding gebruiken in een runbook
Gebruik de activiteit Get-AutomationConnection om een verbinding in een runbook te gebruiken. Deze activiteit haalt de waarden van de verschillende velden in de verbinding op en retourneert ze als een hashtabel die vervolgens met de juiste opdrachten in het runbook kan worden gebruikt.
Zie about_Hash_Tables voor meer informatie over hashtabellen.
De volgende voorbeeldcode laat zien hoe u een verbinding gebruikt voor het opgeven van de computernaam en de referenties voor een a8b7e82f-e3fc-4286-8570-8d5ded944b27#bkmk_InlineScript-blok dat opdrachten op een andere computer uitvoert.
$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