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 der 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 namens MyConnection mithilfe der Parameter "Name", " ConnectionTypeName" und " ConnectionFieldValues ".
Parameter
-AuthenticationType
Gibt den Authentifizierungstyp an. Gültige Werte sind:
- Basic
- Windows
Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Credential-Parameters angeben.
| Type: | String |
| Accepted values: | Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionTypeName
Gibt einen Verbindungstyp an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein PSCredential-Objekt für die Verbindung mit dem SMA-Webdienst an.
Verwenden Sie zum Abrufen eines Anmeldeinformationsobjekts das Cmdlet Get-Credential.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die Verbindung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt einen Namen für die Verbindung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
Gibt die Portnummer des SMA-Webdiensts an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WebServiceEndpoint
Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll einschließen, z. B. http:// oder https://.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |