你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzWorkloadsSapVirtualInstance

为 SAP 解决方案 (VIS) 资源创建虚拟实例

语法

New-AzWorkloadsSapVirtualInstance
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Environment <SapEnvironmentType>
   -Location <String>
   -SapProduct <SapProductType>
   -CentralServerVmId <String>
   [-ManagedRgStorageAccountName <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-ManagedResourceGroupName <String>]
   [-ManagedResourcesNetworkAccessType <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWorkloadsSapVirtualInstance
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Environment <SapEnvironmentType>
   -Location <String>
   -SapProduct <SapProductType>
   [-IdentityType <ManagedServiceIdentityType>]
   [-ManagedResourceGroupName <String>]
   [-ManagedResourcesNetworkAccessType <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <Hashtable>]
   -Configuration <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

为 SAP 解决方案 (VIS) 资源创建虚拟实例

示例

示例 1:使用 SAP 解决方案的虚拟实例为三层分布式 SAP 系统部署基础结构

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name L46 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayload.json -Tag @{k1 = "v1"; k2 = "v2"} -IdentityType 'UserAssigned' -ManagedResourceGroupName "L46-rg" -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                       Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                       ------ --------
L46  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     SoftwareInstallationPending        eastus

在此示例中,为三层分布式 SAP 系统部署基础结构。 示例 json 有效负载在此处链接:https://go.microsoft.com/fwlink/?linkid=2230236

示例 2:使用 SAP 解决方案的虚拟实例在为三层分布式 SAP 系统部署的基础结构上安装 SAP 软件

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name L46 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\InstallPayload.json -Tag @{k1 = "v1"; k2 = "v2"} -IdentityType 'UserAssigned' -ManagedResourceGroupName "L46-rg" -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                ------ --------
L46  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     RegistrationComplete        eastus

在此示例中,为三层非高可用性分布式 SAP 系统在部署的基础结构上安装 SAP 软件。 示例 json 有效负载在此处链接:https://go.microsoft.com/fwlink/?linkid=2230167

示例 3:使用 SAP 解决方案的虚拟实例为三层分布式高可用性 SAP 系统部署基础结构

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name SK1 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayloadHACustomNames.json -IdentityType 'UserAssigned' -ManagedResourceGroupName "acss-mrg1" -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                       Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                       ------ --------
SK1  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     SoftwareInstallationPending        eastus

在此示例中,为三层分布式高可用性 (HA) SAP 系统部署基础结构。

示例 4:使用 SAP 解决方案的虚拟实例在为三层分布式高可用性 (HA) SAP 系统部署的基础结构上安装 SAP 软件

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name SK1 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayloadHACustomNamesInstall.json -IdentityType 'UserAssigned' -ManagedResourceGroupName "acss-mrg1" -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                ------ --------
SK1  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     RegistrationComplete        eastus

在此示例中,将使用传输目录和自定义资源命名的三层分布式高可用性 SAP 系统在部署的基础结构上安装 SAP 软件。

示例 5:将现有 SAP 系统注册为 VIS

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'TestRG' -Name L46 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -CentralServerVmId '/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/powershell-cli-testrg/providers/microsoft.compute/virtualmachines/l46ascsvm' -Tag @{k1 = "v1"; k2 = "v2"} -IdentityType 'UserAssigned' -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                ------ --------
L46  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     RegistrationComplete        eastus

将 New-AzWorkloadsSapVirtualInstance cmdlet 与建议的输入参数配合使用,将现有 SAP 系统注册为 SAP 解决方案资源的虚拟实例。

示例 6:使用自定义托管资源组和托管存储帐户名称以及托管存储帐户网络访问类型设置将现有 SAP 系统注册为 SAP 解决方案资源的虚拟实例。

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'TestRG' -Name L46 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -CentralServerVmId '/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/powershell-cli-testrg/providers/microsoft.compute/virtualmachines/l46ascsvm' -Tag @{k1 = "v1"; k2 = "v2"} -ManagedResourceGroupName "L46-rg" -ManagedRgStorageAccountName 'acssstoragel46' -ManagedResourcesNetworkAccessType 'Private' -IdentityType 'UserAssigned' -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                ------ --------
L46  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     RegistrationComplete        eastus

将 New-AzWorkloadsSapVirtualInstance cmdlet 与建议的输入参数配合使用,将现有 SAP 系统注册为具有自定义托管资源组和托管存储帐户名称的 SAP 解决方案资源的虚拟实例,并按照安全要求指定托管存储帐户网络访问类型设置。 了解详细信息:https://go.microsoft.com/fwlink/?linkid=2256933

示例 7:使用 Azure 计算加仑映像为三层分布式高可用性 (HA) SAP 系统部署基础结构

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name SK1 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayloadHACustomNames.json -IdentityType 'UserAssigned' -ManagedResourceGroupName "acss-mrg1" -UserAssignedIdentity @{'/subscriptions/49d64d54-e966-4c46-a868-1999802b762c/resourcegroups/SAP-E2ETest-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/E2E-RBAC-MSI'= @{}}

Name ResourceGroupName     Health Environment ProvisioningState SapProduct State                       Status Location
---- -----------------     ------ ----------- ----------------- ---------- -----                       ------ --------
SK1  PowerShell-CLI-TestRG        NonProd     Succeeded         S4HANA     SoftwareInstallationPending        eastus

在此示例中,你将使用 Azure 计算加仑映像为三层分布式高可用性 (HA) SAP 系统部署基础结构。 请参阅此处的示例 json 有效负载:https://go.microsoft.com/fwlink/?linkid=2263420

参数

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CentralServerVmId

中央服务器的虚拟机 ID

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Configuration

配置 json 路径。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Environment

定义环境类型 - 生产/非生产。

类型:SapEnvironmentType
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-IdentityType

管理标识的类型

类型:ManagedServiceIdentityType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

资源所在的地理位置

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ManagedResourceGroupName

托管资源组名称

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ManagedResourcesNetworkAccessType

托管资源网络访问类型

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ManagedRgStorageAccountName

在 VIS 部署过程中创建的托管资源组中服务创建的存储帐户的自定义存储帐户名称。

请参阅此处存储帐户命名规则。

如果未提供,该服务将创建具有随机名称的存储帐户

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

SAP 解决方案资源的虚拟实例的名称

类型:String
别名:SapVirtualInstanceName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称。 名称不区分大小写。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SapProduct

定义 SAP 产品类型。

类型:SapProductType
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SubscriptionId

目标订阅的 ID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UserAssignedIdentity

用户分配的标识字典

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

ISapVirtualInstance

备注

别名

New-AzVIS