Share via

Set-SmaVariable

  • Reference
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Vytvoří nebo upraví proměnnou v SMA.

Syntax

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

Description

Rutina Set-SmaVariable vytvoří nebo upraví proměnnou ve službě System Management Automation (SMA). Zadejte název proměnné a hodnoty.

K šifrování proměnné použijte parametr Encrypted . Po vytvoření nelze změnit šifrovaný stav proměnné. Tato rutina selže, pokud použijete parametr Encrypted u existující nešifrované proměnné.

Příklady

Příklad 1: Přiřazení hodnoty proměnné

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

Tento příkaz přiřadí hodnotu String07 proměnné s názvem Variable01 pro zadaný koncový bod webové služby. Protože příkaz určuje parametr Encrypted , zašifruje proměnnou.

Parametry

-AuthenticationType

Určuje typ ověřování. Platné hodnoty jsou:

  • Basic
  • Windows

Výchozí hodnota tohoto parametru je Windows. Pokud používáte základní ověřování, musíte zadat přihlašovací údaje pomocí parametru Credential .

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje objekt PSCredential pro připojení k webové službě SMA. K získání objektu přihlašovacích údajů použijte rutinu Get-Credential. Další informace zobrazíte zadáním Get-Help Get-Credential.

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

-Description

Poskytuje popis proměnné.

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

-Encrypted

Označuje, že tato rutina zašifruje proměnnou.

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

-Force

Upraví proměnnou bez zobrazení výzvy k potvrzení. Rutina vás vyzve k potvrzení, než bude pokračovat, pokud jako hodnotu parametru Value zadáte secureString. Tato rutina vás také vyzve, pokud hodnota obsahuje objekt s secureString jako pole a nepoužíváte šifrovaný parametr.

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

-Name

Určuje název proměnné.

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

-Port

Určuje číslo portu webové služby SMA.

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

-Value

Určuje hodnotu proměnné.

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

-WebServiceEndpoint

Určuje koncový bod jako adresu URL webové služby SMA. Musíte zahrnout protokol, například http:// nebo https://.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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