Partilhar via

New-AzDevCenterUserDevBoxCustomizationGroup

  • Referência
Módulo:
Az.DevCenter

Aplica personalizações à Caixa de Desenvolvimento.

Sintaxe

New-AzDevCenterUserDevBoxCustomizationGroup
   -Endpoint <String>
   -CustomizationGroupName <String>
   -DevBoxName <String>
   -ProjectName <String>
   [-UserId <String>]
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserDevBoxCustomizationGroup
   -Endpoint <String>
   -InputObject <IDevCenterdataIdentity>
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserDevBoxCustomizationGroup
   -DevCenterName <String>
   -InputObject <IDevCenterdataIdentity>
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDevCenterUserDevBoxCustomizationGroup
   -DevCenterName <String>
   -CustomizationGroupName <String>
   -DevBoxName <String>
   -ProjectName <String>
   [-UserId <String>]
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Aplica personalizações à Caixa de Desenvolvimento.

Exemplos

Exemplo 1: Criar um grupo de personalização por ponto de extremidade

$task = @{
    Name = "catalogName/choco"
    DisplayName = "choco"
    Parameter = @{
        PackageName = "vscode"
        PackageVersion = "1.0.0"
    }
    RunAs = "System"
    TimeoutInSecond = 120
}
$tasks = @($task)
New-AzDevCenterUserDevBoxCustomizationGroup -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -ProjectName DevProject -UserId 786a823c-8037-48ab-89b8-8599901e67d0 -DevBoxName myDevBox -CustomizationGroupName Provisioning -Task $tasks

Este comando cria o grupo de personalização "Provisoning" para a caixa de desenvolvimento "myDevBox".

Exemplo 2: Criar um grupo de personalizaçãopor centro de desenvolvimento

New-AzDevCenterUserDevBoxCustomizationGroup -DevCenterName Contoso -ProjectName DevProject -UserId "me" -DevBoxName myDevBox -CustomizationGroupName Provisioning -Task $tasks

Este comando cria o grupo de personalização "Provisoning" para a caixa de desenvolvimento "myDevBox".

Exemplo 3: Criar um grupo de personalização por ponto de extremidade e InputObject

$customizationGroupInput = @{"CustomizationGroupName" = "Provisioning"; "DevBoxName" = "myDevBox"; "UserId" = "me"; "ProjectName" = "DevProject" }
New-AzDevCenterUserDevBoxCustomizationGroup -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -InputObject $customizationGroupInput -Task $tasks

Este comando cria o grupo de personalização "Provisoning" para a caixa de desenvolvimento "myDevBox".

Exemplo 4: Criar um grupo de personalização pelo centro de desenvolvimento e InputObject

$customizationGroupInput = @{"CustomizationGroupName" = "Provisioning"; "DevBoxName" = "myDevBox"; "UserId" = "786a823c-8037-48ab-89b8-8599901e67d0"; "ProjectName" = "DevProject" }
New-AzDevCenterUserDevBoxCustomizationGroup -DevCenterName Contoso -InputObject $customizationGroupInput -Task $tasks

Este comando cria o grupo de personalização "Provisoning" para a caixa de desenvolvimento "myDevBox".

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CustomizationGroupName

Um nome de grupo de personalização.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DevBoxName

O nome de uma caixa de desenvolvimento.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DevCenterName

O DevCenter sobre o qual executar operações.

Tipo:String
Aliases:DevCenter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Endpoint

O URI específico do DevCenter para operar.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:IDevCenterdataIdentity
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProjectName

O Projeto DevCenter sobre o qual executar operações.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Task

Tarefas a aplicar. Observação Por padrão, as tarefas são excluídas da resposta ao listar grupos de personalização. Para incluí-los, use o include=tasks queryparameter. Para construir, consulte a seção NOTAS para propriedades TASK e crie uma tabela de hash.

Tipo:ICustomizationTask[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserId

A ID do objeto AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Tipo:String
Position:Named
Default value:"me"
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

Saídas