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

New-AzWorkloadsSapVirtualInstance

模块:: Az.Workloads Module

为 SAP 解决方案（VIS）资源创建虚拟实例

语法

CreateWithDiscovery （默认值）

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

CreateWithJsonTemplatePath

New-AzWorkloadsSapVirtualInstance
    -Name <String>
    -ResourceGroupName <String>
    -Environment <SapEnvironmentType>
    -Location <String>
    -SapProduct <SapProductType>
    -Configuration <String>
    [-SubscriptionId <String>]
    [-IdentityType <ManagedServiceIdentityType>]
    [-ManagedResourceGroupName <String>]
    [-ManagedResourcesNetworkAccessType <String>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <Hashtable>]
    [-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
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CentralServerVmId

中央服务器的虚拟机 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateWithDiscovery

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Configuration

配置 json 路径。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateWithJsonTemplatePath

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Environment

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

参数属性

类型:	SapEnvironmentType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-IdentityType

管理标识的类型

参数属性

类型:	ManagedServiceIdentityType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Location

资源所在的地理位置

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedResourceGroupName

托管资源组名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedResourcesNetworkAccessType

托管资源网络访问类型

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedRgStorageAccountName

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

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateWithDiscovery

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	SapVirtualInstanceName

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NoWait

异步运行命令

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SapProduct

定义 SAP 产品类型。

参数属性

类型:	SapProductType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscriptionId

目标订阅的 ID。

参数属性

类型:	String
默认值:	(Get-AzContext).Subscription.Id
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Tag

资源标记。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserAssignedIdentity

用户分配的标识字典

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

输出

ISapVirtualInstance

备注

别名

New-AzVIS

反馈

此页面是否有帮助？

通过

New-AzWorkloadsSapVirtualInstance

语法

CreateWithDiscovery （默认值）

CreateWithJsonTemplatePath

说明

示例

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

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

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

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

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

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

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

参数

-AsJob

参数属性

参数集

-CentralServerVmId

参数属性

参数集

-Configuration

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Environment

参数属性

参数集

-IdentityType

参数属性

参数集

-Location

参数属性

参数集

-ManagedResourceGroupName

参数属性

参数集

-ManagedResourcesNetworkAccessType

参数属性

参数集

-ManagedRgStorageAccountName

参数属性

参数集

-Name

参数属性

参数集

-NoWait

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-SapProduct

参数属性

参数集

-SubscriptionId

参数属性

参数集

-Tag

参数属性

参数集

-UserAssignedIdentity

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输出

ISapVirtualInstance

备注

反馈

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

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