Partilhar via


New-AzDevCenterUserDevBoxCustomizationGroup

Aplica personalizações à Caixa de Desenvolvimento.

Sintaxe

CreateExpanded (Predefinição)

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

CreateViaIdentityExpanded

New-AzDevCenterUserDevBoxCustomizationGroup
    -Endpoint <String>
    -InputObject <IDevCenterdataIdentity>
    [-Task <ICustomizationTask[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpandedByDevCenter

New-AzDevCenterUserDevBoxCustomizationGroup
    -DevCenterName <String>
    -InputObject <IDevCenterdataIdentity>
    [-Task <ICustomizationTask[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateExpandedByDevCenter

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 "Provisionamento" para a caixa de desenvolvimento "myDevBox".

Exemplo 2: Criar um grupo de personalização pelo 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 "Provisionamento" 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 "Provisionamento" 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 "Provisionamento" para a caixa de desenvolvimento "myDevBox".

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CustomizationGroupName

Um nome de grupo de personalização.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSObject
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzureRMContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DevBoxName

O nome de uma caixa de desenvolvimento.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DevCenterName

O DevCenter sobre o qual executar operações.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Centro de Desenvolvimento

Conjuntos de parâmetros

CreateViaIdentityExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Endpoint

O URI específico do DevCenter para operar.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

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

Propriedades dos parâmetros

Tipo:IDevCenterdataIdentity
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateViaIdentityExpanded
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateViaIdentityExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProjectName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateExpandedByDevCenter
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

ICustomizationTask[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UserId

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

Propriedades dos parâmetros

Tipo:String
Default value:me
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

CreateExpanded
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
CreateExpandedByDevCenter
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

IDevCenterdataIdentity

Saídas

ICustomizationGroup