Delen via

New-SmaConnection

  • Referentie
Module:
Microsoft.SystemCenter.ServiceManagementAutomation

Hiermee maakt u een verbindingsexemplaren in SMA.

Syntaxis

New-SmaConnection
   -Name <String>
   -ConnectionTypeName <String>
   [-ConnectionFieldValues <Hashtable>]
   [-Description <String>]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

De cmdlet New-SmaConnection maakt een verbindingsexemplaren in Service Management Automation (SMA).

Voorbeelden

Voorbeeld 1: Een verbinding maken

PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="PattiFuller"; Password="passw0rd!"}

Met deze opdracht maakt u een verbinding met de naam MyConnection met behulp van de parameters Name, ConnectionTypeNameen ConnectionFieldValue s.

Voorzichtigheid

Microsoft raadt u aan de veiligste verificatiestroom te gebruiken die beschikbaar is. De verificatiestroom die in dit voorbeeld wordt beschreven, vereist een zeer hoge mate van vertrouwen in de toepassing en brengt risico's met zich mee die niet aanwezig zijn in andere stromen.

Parameters

-AuthenticationType

Hiermee geeft u het verificatietype. Geldige waarden zijn:

  • Basisch
  • Ramen

De standaardwaarde voor deze parameter is Windows. Als u basisverificatie gebruikt, moet u referenties opgeven met behulp van de parameter Credential.

Type:String
Geaccepteerde waarden:Basic, Windows
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConnectionFieldValues

Hiermee geeft u een hash-tabel op die sleutel- en waardeparen bevat. De sleutels vertegenwoordigen de verbindingsvelden op het opgegeven verbindingstype. De waarden vertegenwoordigen de specifieke waarden die moeten worden opgeslagen voor elk verbindingsveld voor het verbindingsexemplaren.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConnectionTypeName

Hiermee geeft u een verbindingstype op.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de SMA-webservice. Gebruik de cmdlet Get-Credential om een referentieobject op te halen. Typ Get-Help Get-Credentialvoor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor de verbinding.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een naam voor de verbinding.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Port

Hiermee geeft u het poortnummer van de SMA-webservice.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WebServiceEndpoint

Hiermee geeft u het eindpunt, als URL, van de SMA-webservice. U moet het protocol opnemen, bijvoorbeeld http:// of https://.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False