Condividi tramite

New-SmaConnection

  • Riferimento
Modulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Crea un'istanza di connessione in SMA.

Sintassi

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

Descrizione

Il cmdlet New-SmaConnection crea un'istanza di connessione in Service Management Automation (SMA).

Esempio

Esempio 1: Creare una connessione

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!"}

Questo comando crea una connessione denominata MyConnection usando i parametriNome , ConnectionTypeNamee ConnectionFieldValues.

Cautela

Microsoft consiglia di usare il flusso di autenticazione più sicuro disponibile. Il flusso di autenticazione descritto in questo esempio richiede un livello di attendibilità molto elevato nell'applicazione e comporta rischi che non sono presenti in altri flussi.

Parametri

-AuthenticationType

Specifica il tipo di autenticazione. I valori validi sono:

  • Basico
  • Finestre

Il valore predefinito per questo parametro è Windows. Se si usa l'autenticazione di base, è necessario specificare le credenziali usando il parametro credenziali.

Tipo:String
Valori accettati:Basic, Windows
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConnectionFieldValues

Specifica una tabella hash che contiene coppie chiave e valore. Le chiavi rappresentano i campi di connessione nel tipo di connessione specificato. I valori rappresentano i valori specifici da archiviare per ogni campo di connessione per l'istanza di connessione.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConnectionTypeName

Specifica un tipo di connessione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un oggetto PSCredential per la connessione al servizio Web SMA. Per ottenere un oggetto credenziale, usare il cmdlet Get-Credential. Per altre informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la connessione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica un nome per la connessione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Port

Specifica il numero di porta del servizio Web SMA.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WebServiceEndpoint

Specifica l'endpoint, come URL, del servizio Web SMA. È necessario includere il protocollo, ad esempio http:// o https://.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False