Sdílet prostřednictvím

Set-SmaVariable

  • Reference
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

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

Syntaxe

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 hodnotu.

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:

  • Základní
  • 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í přihlašovacích údajů parametru.

Typ:String
Přípustné hodnoty:Basic, Windows
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 potřebujete zadáním Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Poskytuje popis proměnné.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Encrypted

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Upraví proměnnou bez výzvy k potvrzení. Rutina vás vyzve k potvrzení, než bude pokračovat, pokud jako hodnotu pro parametr Value zadáte řetězec SecureString. Tato rutina vás také vyzve, pokud hodnota obsahuje objekt se secureString jako pole a nepoužíváte parametr Encrypted.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název proměnné.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Port

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Value

Určuje hodnotu proměnné.

Typ:Object
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WebServiceEndpoint

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

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False