New-SmaConnection
Erstellt eine Verbindungsinstanz in SMA.
Syntax
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] Beschreibung
Das cmdlet New-SmaConnection erstellt eine Verbindungsinstanz in Service Management Automation (SMA).
Beispiele
Beispiel 1: Erstellen einer Verbindung
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!"}Dieser Befehl erstellt eine Verbindung mit dem Namen MyConnection mithilfe der Parameter Name, ConnectionTypeNameund ConnectionFieldValues Parameter.
Vorsicht
Microsoft empfiehlt, den sichersten Authentifizierungsfluss zu verwenden. Der in diesem Beispiel beschriebene Authentifizierungsfluss erfordert ein sehr hohes Vertrauen in die Anwendung und trägt Risiken, die in anderen Flüssen nicht vorhanden sind.
Parameter
-AuthenticationType
Gibt den Authentifizierungstyp an. Gültige Werte sind:
- Grundlegend
- Fenster
Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Parameters Anmeldeinformationen angeben.
| Typ: | String |
| Zulässige Werte: | Basic, Windows |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConnectionFieldValues
Gibt eine Hashtabelle an, die Schlüssel- und Wertpaare enthält. Die Schlüssel stellen die Verbindungsfelder für den angegebenen Verbindungstyp dar. Die Werte stellen die spezifischen Werte dar, die für jedes Verbindungsfeld für die Verbindungsinstanz gespeichert werden sollen.
| Typ: | Hashtable |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConnectionTypeName
Gibt einen Verbindungstyp an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt ein PSCredential -Objekt für die Verbindung mit dem SMA-Webdienst an.
Verwenden Sie das Cmdlet Get-Credential, um ein Anmeldeinformationsobjekt abzurufen.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die Verbindung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen Namen für die Verbindung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Port
Gibt die Portnummer des SMA-Webdiensts an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WebServiceEndpoint
Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll einschließen, z. B. http:// oder https://.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |