Update-AzureRmApiManagementDeployment

Riferimento

Modulo:: AzureRM.ApiManagement

Aggiornamenti distribuzione di un servizio Gestione API.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Update-AzureRmApiManagementDeployment
      -ResourceGroupName <String>
      -Name <String>
      -Location <String>
      -Sku <PsApiManagementSku>
      -Capacity <Int32>
      [-VirtualNetwork <PsApiManagementVirtualNetwork>]
      [-VpnType <PsApiManagementVpnType>]
      [-AdditionalRegions <System.Collections.Generic.IList`1[Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Update-AzureRmApiManagementDeployment
      -ApiManagement <PsApiManagement>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Descrizione

Il cmdlet Update-AzureRmApiManagementDeployment aggiorna le distribuzioni correnti di un servizio Gestione API.

Esempio

Esempio 1: Aggiornare una distribuzione di un'istanza di ApiManagement

PS C:\>Update-AzureRmApiManagementDeployment -ResourceGroupName "Contoso" -Name "ContosoApi" -Sku "Standard" -Capacity 3

Questo comando aggiorna la distribuzione di un'istanza di Gestione API a uno standard di capacità a tre unità.

Esempio 2: Ottenere un'istanza di ApiManagement e ridimensionarla

PS C:\>$ApiManagement = Get-AzureRmApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi"
PS C:\> $ApiManagement.Sku = "Premium"
PS C:\> $ApiManagement.Capacity = 5
PS C:\> $ApiManagement.AddRegion("Central US", "Premium", 3)
PS C:\> Update-AzureRmApiManagementDeployment -ApiManagement $ApiManagement

Questo esempio ottiene un'istanza di Gestione API, la ridimensiona a cinque unità Premium e quindi aggiunge altre tre unità all'area Premium.

Esempio 3: Distribuzione degli aggiornamenti (rete virtuale esterna)

PS C:\> $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location "East US" -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-WestUS/providers/Microsoft.Network/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
PS C:\> Update-AzureRmApiManagementDeployment -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetwork $virtualNetwork -VpnType "External"

Questo comando aggiorna una distribuzione Gestione API esistente e viene aggiunta a un vpnType esterno.

Esempio 4: Distribuzione degli aggiornamenti (rete virtuale interna)

PS C:\> $virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location "East US" -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/Api-Default-WestUS/providers/Microsoft.ClassicNetwork/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
PS C:\> Update-AzureRmApiManagementDeployment -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetwork $virtualNetwork -VpnType "Internal"

Questo comando aggiorna una distribuzione Gestione API esistente e viene aggiunta a un vpnType interno.

Parametri

-AdditionalRegions

Specifica aree di distribuzione aggiuntive di Azure Gestione API.

Type:	IList<T>[PsApiManagementRegion]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApiManagement

Specifica l'istanza di PsApiManagement da cui ottenere la configurazione della distribuzione. Usare questo parametro se l'istanza include già tutte le modifiche necessarie.

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

-Capacity

Specifica la capacità sku dell'area di distribuzione master di Azure Gestione API.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Specifica il percorso dell'area di distribuzione master Gestione API. Per ottenere percorsi validi, usare il cmdlet Get-AzureRmResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | dove {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Posizioni dell'oggetto Select

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

-Name

Specifica il nome di Gestione API aggiornato da questo cmdlet.

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

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse in cui esiste Gestione API.

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

-Sku

Specifica il livello dell'area di distribuzione master di Azure Gestione API. I valori validi per questo parametro sono:

Sviluppatore
Standard
Premium

Type:	PsApiManagementSku
Accepted values:	Developer, Standard, Premium, Basic
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualNetwork

Specifica la configurazione Rete virtuale dell'area di distribuzione master di Azure Gestione API.

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

-VpnType

Specifica il tipo di rete virtuale della distribuzione Gestione API. I valori validi per questo parametro sono:

Nessuno. La distribuzione Gestione API non fa parte di alcuna Rete virtuale. Questo è il valore predefinito.
Esterno. La distribuzione Gestione API ha un indirizzo virtuale esterno.
Interne. La distribuzione Gestione API ha un indirizzo virtuale con connessione Intranet.

Type:	PsApiManagementVpnType
Accepted values:	None, External, Internal
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Input

PsApiManagement

Parametri: ApiManagement (ByValue)

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

PsApiManagementVpnType

IList<T>[[Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion, Microsoft.Azure.Commands.ApiManagement, Version=6.1.2.0, Culture=neutral, PublicKeyToken=null]]

Output