Artikel
05/31/2016

Referenties

Van toepassing op: Windows Azure Pack for Windows Server, System Center 2012 R2 Orchestrator

Een Automatisering-referentie is ofwel een gebruikersnaam en wachtwoord die kunnen worden gebruikt met Windows PowerShell-opdrachten of een certificaat dat is geüpload naar de server. De eigenschappen van een referentie worden veilig opgeslagen in de Automatisering-database en kunnen worden geopend in het runbook met ofwel de Get-AutomationPSCredential- of de Get-AutomationCertificate-activiteit.

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
Get-SmaCertificate	Hiermee haalt u een Automatisering-certificaat op.
Get-SmaCredential	Hiermee haalt u een Automatisering PowerShell-referentie op.
Remove-SmaCertificate	Hiermee verwijdert u een Automatisering-certificaat.
Remove-SmaCredential	Hiermee verwijdert u een Automatisering PowerShell-referentie.
Set-SmaCertificate	Hiermee creëert u een nieuw certificaat of stelt u de eigenschappen van een bestaand certificaat in, met inbegrip van het uploaden van het certificaatbestand en het instellen van het wachtwoord voor een .pfx-bestand.
Set-SmaCredential	Hiermee creëert u een nieuwe Automatisering PowerShell-referentie of stelt u de eigenschappen van een bestaande referentie in.

Runbookactiviteiten

De activiteiten in de volgende tabel worden gebruikt voor toegang tot referenties in een runbook.

Activiteiten	Beschrijving
Get-AutomationCertificate	Hiermee haalt u een certificaat op dat moet worden gebruikt in een runbook.
Get-AutomationPSCredential	Hiermee haalt u een gebruikersnaam en wachtwoord op voor gebruik in een runbook.

Notitie

Vermijd het gebruik van variabelen in de parameter -Name van Get-AutomationPSCredential en Get-AutomationCertificate aangezien dit het detecteren van afhankelijkheden tussen runbooks en Automatisering-variabelen kan bemoeilijken.

Een nieuwe referentie maken

Een nieuwe PowerShell-referentie 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 Gebruikersreferentie toevoegen.
In de vervolgkeuzelijst Type gebruikersreferentie selecteert u PowerShell-referentie.
Typ een naam voor de referentie in het vak Naam.
Klik op de pijl-rechts.
Typ waarden voor elke eigenschap.
Klik op het vinkje om de referentie op te slaan.

Een nieuw certificaat 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 Gebruikersreferentie toevoegen.
In de vervolgkeuzelijst Type gebruikersreferentie selecteert u Certificaat.
Typ een naam voor het certificaat in het vak Naam.
Klik op de pijl-rechts.
Klik op Bladeren naar bestand en navigeer naar een .cer- of .pfx-bestand.
Als u een .pfx-bestand hebt geselecteerd, geeft u vervolgens het wachtwoord op.
Klik op het vinkje om het certificaat op te slaan.

Een nieuwe PowerShell-referentie maken met Windows PowerShell in Service Management Automation

De volgende voorbeeldopdrachten laten zien hoe u een nieuwe referentie maakt.

$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

Een nieuw PowerShell-certificaat maken met Windows PowerShell in Service Management Automation

De volgende voorbeeldopdrachten laten zien hoe u een nieuw certificaat maakt door een certificaatbestand te importeren.

$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

Met behulp van een PowerShell-referentie in een runbook

U haalt een PowerShell-referentie in een runbook op met de activiteit Get-AutomationPSCredential. Dit retourneert een PSCredential-object dat u kunt gebruiken in de werkstroom.

Een PowerShell-referentie gebruiken in een runbook

De volgende voorbeeldopdrachten laten zien hoe u een PowerShell-referentie gebruikt in een runbook. In dit voorbeeld wordt de referentie gebruikt met een InlineScript-activiteit voor het uitvoeren van een reeks opdrachten met alternatieve referenties.
```
$myCredential = Get-AutomationPSCredential -Name 'MyCredential'
InlineScript {
   <Commands>
} -PSComputerName $ServerName -PSCredential $myCredential
```

Zie ook

Service Management Automation
Automation-runbooks ontwerpen
Globale activa

Delen via