Update-AzApiManagementRegion

Memperbarui wilayah penyebaran yang ada di instans PsApiManagement.

Sintaks

Update-AzApiManagementRegion
      -ApiManagement <PsApiManagement>
      -Location <String>
      -Sku <string>
      -Capacity <Int32>
      [-VirtualNetwork <PsApiManagementVirtualNetwork>]
      [-Zone <String[]>]
      [-DisableGateway <Boolean>]
      [-PublicIpAddressId <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Deskripsi

Cmdlet Update-AzApiManagementRegion memperbarui instans jenis Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion dalam kumpulan objek AdditionalRegions dari instans jenis microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Cmdlet ini tidak menyebarkan apa pun kecuali memperbarui instans PsApiManagement dalam memori. Untuk memperbarui penyebaran API Management, gunakan PsApiManagementInstance yang dimodifikasi ke cmdlet Set-AzApiManagement.

Contoh

Contoh 1: Meningkatkan kapasitas Wilayah Tambahan dalam instans PsApiManagement

$apimService = Get-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName
$apimService = Update-AzApiManagementRegion -ApiManagement $apimService -Location "North Central US" -Capacity 2 -Sku Premium
$apimService = Set-AzApiManagement -InputObject $apimService -PassThru

Perintah ini mendapatkan layanan API Management Premium SKU, memiliki wilayah di US Tengah Selatan dan US Tengah Utara. Kemudian meningkatkan Kapasitas wilayah US Tengah Utara menjadi 2 menggunakan Set-AzApiManagement. Cmdlet berikutnya Set-AzApiManagement menerapkan perubahan konfigurasi ke layanan Api Management.

Contoh 2

Memperbarui wilayah penyebaran yang ada di instans PsApiManagement. (dibuat otomatis)

Update-AzApiManagementRegion -ApiManagement <PsApiManagement> -Capacity 2 -Location 'North Central US' -Sku Developer -VirtualNetwork <PsApiManagementVirtualNetwork>

Parameter

-ApiManagement

Menentukan instans PsApiManagement untuk memperbarui wilayah penyebaran yang ada.

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

-Capacity

Menentukan nilai kapasitas SKU baru untuk wilayah penyebaran.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

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

-DisableGateway

Bendera hanya dimaksudkan untuk digunakan untuk penyebaran Premium SKU ApiManagement Service dan Non Internal VNET. Ini berguna jika kita ingin mengambil wilayah gateway dari rotasi. Ini juga dapat digunakan untuk berdiri di wilayah baru dalam mode Pasif, mengujinya dan kemudian membuatnya Langsung nanti.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Menentukan lokasi wilayah penyebaran yang akan diperbarui. Menentukan lokasi wilayah penyebaran baru di antara wilayah yang didukung untuk layanan Api Management. Untuk mendapatkan lokasi yang valid, gunakan cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | di mana {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Pilih Lokasi Objek

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

-PublicIpAddressId

ResoureId PublicIpAddress SKU Standar untuk integrasi ke dalam Penyebaran Jaringan Virtual stv2

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

-Sku

Menentukan nilai tingkat baru untuk wilayah penyebaran. Nilai yang valid adalah:

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

-VirtualNetwork

Menentukan konfigurasi jaringan virtual untuk wilayah penyebaran. Melewati $null akan menghapus konfigurasi jaringan virtual untuk wilayah tersebut.

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

-Zone

Daftar zona ketersediaan yang menunjukkan tempat layanan manajemen api disebarkan.

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

Input

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Output

PsApiManagement