New-SmaConnection
Tworzy wystąpienie połączenia w programie SMA.
Składnia
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] Opis
Polecenie cmdlet New-SmaConnection tworzy wystąpienie połączenia w programie Service Management Automation (SMA).
Przykłady
Przykład 1. Tworzenie połączenia
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!"}To polecenie tworzy połączenie o nazwie MyConnection przy użyciu parametrów Name, ConnectionTypeNamei ConnectionFieldValues parametrów.
Ostrożność
Firma Microsoft zaleca korzystanie z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Przepływ uwierzytelniania opisany w tym przykładzie wymaga bardzo wysokiego poziomu zaufania w aplikacji i niesie ze sobą ryzyko, które nie występują w innych przepływach.
Parametry
-AuthenticationType
Określa typ uwierzytelniania. Prawidłowe wartości to:
- Podstawowy
- Windows
Wartość domyślna tego parametru to Windows. Jeśli używasz uwierzytelniania podstawowego, musisz podać poświadczenia przy użyciu parametru Credential.
| Typ: | String |
| Dopuszczalne wartości: | Basic, Windows |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ConnectionFieldValues
Określa tabelę skrótów zawierającą pary klucz i wartość. Klucze reprezentują pola połączenia w określonym typie połączenia. Wartości reprezentują określone wartości do przechowywania dla każdego pola połączenia dla wystąpienia połączenia.
| Typ: | Hashtable |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ConnectionTypeName
Określa typ połączenia.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Credential
Określa obiekt PSCredential dla połączenia z usługą internetową SMA.
Aby uzyskać obiekt poświadczeń, użyj polecenia cmdlet Get-Credential.
Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.
| Typ: | PSCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis połączenia.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę połączenia.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Port
Określa numer portu usługi internetowej SMA.
| Typ: | Int32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WebServiceEndpoint
Określa punkt końcowy jako adres URL usługi internetowej SMA. Należy dołączyć protokół, na przykład http:// lub https://.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |