New-PSUVariable

ÜBERSICHT

Erstellt eine neue Variable in PSU.

SYNTAX

Value (Standard)

New-PSUVariable -Name <String> [-Value <Object>] [-Type <String>] [-Description <String>]
 [-DisableRunAsSupport] [-Database] [-Role <String[]>] [-Force] [-Scope <VariableScope>] [-Tag <Tag[]>]
 [-PasswordNotRequired] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

Secret

New-PSUVariable -Name <String> [-Value <Object>] [-InputObject <Object>] -Vault <String> [-Type <String>]
 [-Description <String>] [-DisableRunAsSupport] [-Database] [-Role <String[]>] [-Force]
 [-Scope <VariableScope>] [-Tag <Tag[]>] [-PasswordNotRequired] [-ComputerName <String>] [-AppToken <String>]
 [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

InputObject

New-PSUVariable -Name <String> [-InputObject <Object>] [-Type <String>] [-Description <String>]
 [-DisableRunAsSupport] [-Database] [-Role <String[]>] [-Force] [-Scope <VariableScope>] [-Tag <Tag[]>]
 [-PasswordNotRequired] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

BESCHREIBUNG

Erstellt eine neue Variable in PSU. Variablen sind in allen Skripten verfügbar, die innerhalb von PSU ausgeführt werden.

BEISPIELE

Beispiel 1

PS C:\> New-UAVariable -Name 'UserName' -Value 'Adam'

Erstellt eine neue Variable in PSU mit dem Namen `UserName`. Sie können die Variable $UserName in allen Ihren Skripten verwenden.

Beispiel 2

PS C:\> New-UAVariable -Name 'UserName' -Value 'Adam' -Vault "Vault"

Erstellt eine neue Variable im Tresor mit dem Namen `Vault`. Der Wert der Variable wird nicht in PSU gespeichert und wird nur beim Ausführen von Skripten abgerufen.

PARAMETER

-AppToken

Ein App-Token für den Zugriff auf die PSU-API.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Die HTTP-Adresse des PSU-REST-API-Servers.

Type: String
Parameter Sets: (All)
Aliases: Uri

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

-Description

Eine Beschreibung für diese Variable.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableRunAsSupport

Verhindert, dass eine Anmeldeinformation für die Run-As-Unterstützung verwendet wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Ein Eingabeobjekt, das als Variable gespeichert wird.

Type: Object
Parameter Sets: Secret, InputObject
Aliases:

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

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Der Name der Variable. Sie können darauf in Ihren Skripten genauso verweisen wie auf andere Variablen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Type

Der .NET-Typ des Objekts .

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Standardanmeldeinformationen bei der Verbindung mit der Management-API verwenden

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Value

Der Wert der Variable.

Type: Object
Parameter Sets: Value, Secret
Aliases:

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

-Vault

Der Tresor, in dem die Variable gespeichert wird.

Type: String
Parameter Sets: Secret
Aliases:

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

-Database

Speichert den Wert der Variable in der Datenbank.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Überschreibt vorhandene Variablen mit demselben Namen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Role

Die Rollen, die auf diese Variable zugreifen können.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Credential

Anmeldeinformationen für die Anmeldung bei der PowerShell Universal Management-API.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Scope

Der Variablenbereich für diese Variable. Änderungen an globalen Variablen führen zu einem Neustart der Ressourcen. Bei Variablen mit Skriptbereich ist dies nicht der Fall.

Type: VariableScope
Parameter Sets: (All)
Aliases:

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

-Tag

Tags für diese Variable.

Type: Tag[]
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Ob das Cmdlet Zertifikatsprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PasswordNotRequired

Gibt an, dass für diese Variable kein Passwort erforderlich ist. Dies ist nützlich für Konten wie gruppenverwaltete Dienstkonten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Cookies

Verwendet und speichert Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.