Share via

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 non crittografata esistente.

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:

  • Basic
  • Windows

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

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Fornisce una descrizione per la variabile.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Encrypted

Indica che questo cmdlet crittografa la variabile.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Modifica la variabile senza richiedere 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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Consente di specificare il nome della variabile.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Port

Specifica il numero di porta del servizio Web SMA.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Specifica un valore per la variabile.

Type:Object
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WebServiceEndpoint

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False