Backup-AzApiManagement
Резервное копирование службы управления API.
Синтаксис
Default (По умолчанию)
Backup-AzApiManagement
-ResourceGroupName <String>
-Name <String>
-StorageContext <IStorageContext>
-TargetContainerName <String>
[-TargetBlobName <String>]
[-AccessType <String>]
[-IdentityClientId <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Backup-AzApiManagement резервное копирование экземпляра службы Azure API Management.
Этот командлет сохраняет резервную копию в виде большого двоичного объекта служба хранилища Azure.
Примеры
Пример 1. Резервное копирование службы управления API
New-AzStorageAccount -StorageAccountName "ContosoStorage" -Location $location -ResourceGroupName "ContosoGroup02" -Type Standard_LRS
$storageKey = (Get-AzStorageAccountKey -ResourceGroupName "ContosoGroup02" -StorageAccountName "ContosoStorage")[0].Value
$storageContext = New-AzStorageContext -StorageAccountName "ContosoStorage" -StorageAccountKey $storageKey
Backup-AzApiManagement -ResourceGroupName "ContosoGroup02" -Name "ContosoApi" -StorageContext $StorageContext -TargetContainerName "contosobackups" -TargetBlobName "contosobackups.apimbackup"
Пример 2. Резервное копирование с помощью управляемого удостоверения
$storageContext=New-AzStorageContext -StorageAccountName apimbackupmsi
$resourceGroupName="contosogroup2";
$apiManagementName="contosoapi";
$containerName="apimbackupcontainer";
$backupName="test-sdk-backup-1";
$msiClientId="00001111-aaaa-2222-bbbb-3333cccc4444"
Backup-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName -StorageContext $storageContext -TargetContainerName $containerName -TargetBlobName $backupName -AccessType "UserAssignedManagedIdentity" -IdentityClientId $msiClientId -PassThru
PublicIPAddresses : {52.143.79.150}
PrivateIPAddresses :
Id : /subscriptions/4f5285a3-9fd7-40ad-91b1-d8fc3823983d/resourceGroups/contosogroup2/providers/Microsoft.ApiManagement/service/contosoapi
Name : contosoapi
Location : West US 2
Sku : Premium
Capacity : 1
CreatedTimeUtc : 10/13/2021 5:49:32 PM
ProvisioningState : Succeeded
RuntimeUrl : https://contosoapi.azure-api.net
RuntimeRegionalUrl : https://contosoapi-westus2-01.regional.azure-api.net
PortalUrl : https://contosoapi.portal.azure-api.net
DeveloperPortalUrl : https://contosoapi.developer.azure-api.net
ManagementApiUrl : https://contosoapi.management.azure-api.net
ScmUrl : https://contosoapi.scm.azure-api.net
PublisherEmail : foobar@microsoft.com
OrganizationName : fsdfsdfs
NotificationSenderEmail : apimgmt-noreply@mail.windowsazure.com
VirtualNetwork :
VpnType : None
PortalCustomHostnameConfiguration :
ProxyCustomHostnameConfiguration : {contosoapi.azure-api.net}
ManagementCustomHostnameConfiguration :
ScmCustomHostnameConfiguration :
DeveloperPortalHostnameConfiguration :
SystemCertificates :
Tags : {}
AdditionalRegions : {}
SslSetting : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementSslSetting
Identity : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementServiceIdentity
EnableClientCertificate :
Zone :
DisableGateway : False
MinimalControlPlaneApiVersion :
PublicIpAddressId :
PlatformVersion : stv2
PublicNetworkAccess : Enabled
PrivateEndpointConnections :
ResourceGroupName : contosogroup2
Эта команда создает резервную копию службы управления API в большой двоичный объект хранилища с помощью управляемого удостоверения UserAssigned
Параметры
-AccessType
Тип доступа, который будет использоваться для учетной записи хранения.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-IdentityClientId
Идентификатор клиента управляемого удостоверения, назначенного пользователем. Требуется только в том случае, если параметр accessType имеет значение UserAssignedManagedIdentity.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Name
Указывает имя развертывания управления API, которое выполняется для резервного копирования этого командлета.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-PassThru
Указывает, что этот командлет возвращает резервные копии объекта PsApiManagement , если операция выполнена успешно.
Свойства параметров
Тип: SwitchParameter
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ResourceGroupName
Указывает имя группы ресурсов, в которой существует развертывание управления API.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-StorageContext
Указывает контекст подключения к хранилищу.
Свойства параметров
Тип: IStorageContext
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-TargetBlobName
Указывает имя большого двоичного объекта для резервной копии.
Если большой двоичный объект не существует, этот командлет создает его.
Этот командлет создает значение по умолчанию на основе следующего шаблона: {Name}-{гггг-ММ-dd-HH-mm}.apimbackup
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-TargetContainerName
Указывает имя контейнера большого двоичного объекта для резервной копии.
Если контейнер не существует, этот командлет создает его.
Свойства параметров
Тип: String
Значение по умолчанию: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные