你当前正在访问 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 |
输出
备注
别名
New-AzVIS