Condividi tramite

Set-SmaVariable

  • Riferimento
Modulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Crea o modifica una variabile in SMA.

Sintassi

Set-SmaVariable
   -Name <String>
   -Value <Object>
   [-Description <String>]
   [-Encrypted]
   [-Force]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SmaVariable crea o modifica una variabile in System Management Automation (SMA). Specificare il nome della variabile e un valore.

Per crittografare la variabile, usare il parametro Encrypted. Non è possibile modificare lo stato crittografato di una variabile dopo la creazione. Questo cmdlet avrà esito negativo se si usa il parametro encrypted in una variabile esistente non crittografata.

Esempio

Esempio 1: Assegnare un valore a una variabile

PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted

Questo comando assegna il valore String07 alla variabile denominata Variable01 per l'endpoint del servizio Web specificato. Poiché il comando specifica il parametro encrypted , crittografa la variabile.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
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

Fornisce una descrizione per la variabile.

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

-Encrypted

Indica che questo cmdlet crittografa la variabile.

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

-Force

Modifica la variabile senza chiedere conferma. Il cmdlet richiede conferma prima di procedere se si specifica secureString come valore per il parametro Value . Questo cmdlet richiede inoltre se il valore contiene un oggetto con SecureString come campo e non si usa il parametro Encrypted.

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

-Name

Specifica il nome di una variabile.

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

-Value

Specifica un valore per la variabile.

Tipo:Object
Posizione:Named
Valore predefinito:None
Necessario:True
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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False