Freigeben über


New-AzDevCenterUserEnvironment

Erstellt oder aktualisiert eine Umgebung.

Syntax

New-AzDevCenterUserEnvironment
   -Endpoint <String>
   -Name <String>
   -ProjectName <String>
   [-UserId <String>]
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserEnvironment
   -Endpoint <String>
   -InputObject <IDevCenterdataIdentity>
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserEnvironment
   -DevCenterName <String>
   -InputObject <IDevCenterdataIdentity>
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserEnvironment
   -DevCenterName <String>
   -Name <String>
   -ProjectName <String>
   [-UserId <String>]
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellt oder aktualisiert eine Umgebung.

Beispiele

Beispiel 1: Erstellen einer Umgebung nach Endpunkt

$functionAppParameters = @{"name" = "testfuncApp" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -Name "envtest" -ProjectName DevProject -CatalogName CentralCatalog -EnvironmentDefinitionName FunctionApp -EnvironmentType DevTest -Parameter $functionAppParameters -ExpirationDate $dateIn8Months

Mit diesem Befehl wird eine Umgebung namens "envtest" für das Projekt "DevProject" erstellt.

Beispiel 2: Erstellen einer Umgebung nach Dev Center

$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -DevCenterName Contoso -Name "envtest" -ProjectName DevProject -CatalogName CentralCatalog -EnvironmentDefinitionName Sandbox -EnvironmentType DevTest -ExpirationDate $dateIn8Months

Mit diesem Befehl wird eine Umgebung namens "envtest" für das Projekt "DevProject" erstellt.

Beispiel 3: Erstellen einer Umgebung nach Endpunkt und InputObject

$envInput = @{"UserId" = "me"; "ProjectName" = "DevProject"; "EnvironmentName" = "envtest" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -InputObject $envInput -CatalogName CentralCatalog -EnvironmentDefinitionName Sandbox -EnvironmentType DevTest -ExpirationDate $dateIn8Months

Mit diesem Befehl wird eine Umgebung namens "envtest" für das Projekt "DevProject" erstellt.

Beispiel 4: Erstellen einer Umgebung durch Dev Center und InputObject

$functionAppParameters = @{"name" = "testfuncApp" }
$envInput = @{"UserId" = "me"; "ProjectName" = "DevProject"; "EnvironmentName" = "envtest" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -DevCenterName Contoso -InputObject $envInput -CatalogName CentralCatalog -EnvironmentDefinitionName FunctionApp -EnvironmentType DevTest -Parameter $functionAppParameters -ExpirationDate $dateIn8Months

Mit diesem Befehl wird eine Umgebung namens "envtest" für das Projekt "DevProject" erstellt.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CatalogName

Name des Katalogs.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DevCenterName

Das DevCenter, auf dem Vorgänge ausgeführt werden sollen.

Typ:String
Aliase:DevCenter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Endpoint

Der DevCenter-spezifische URI, der ausgeführt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnvironmentDefinitionName

Name der Umgebungsdefinition.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnvironmentType

Umgebungstyp.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpirationDate

Die Uhrzeit, zu der das Ablaufdatum ausgelöst wird (UTC), nach dem die Umgebung und die zugehörigen Ressourcen gelöscht werden.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Typ:IDevCenterdataIdentity
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Umgebung.

Typ:String
Aliase:EnvironmentName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Parameter

Parameters-Objekt für die Umgebung.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProjectName

Das DevCenter-Projekt, auf dem Vorgänge ausgeführt werden sollen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserId

Die AAD-Objekt-ID des Benutzers. Wenn der Wert "me" lautet, wird die Identität aus dem Authentifizierungskontext übernommen.

Typ:String
Position:Named
Standardwert:"me"
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben