New-AzWorkloadsSapVirtualInstance

模組:: Az.Workloads Module

建立 SAP 解決方案虛擬實例（VIS）資源

語法

CreateWithDiscovery (預設值)

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

CreateViaJsonFilePath

New-AzWorkloadsSapVirtualInstance
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzWorkloadsSapVirtualInstance
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateWithJsonTemplatePath

New-AzWorkloadsSapVirtualInstance
    -Name <String>
    -ResourceGroupName <String>
    -Environment <String>
    -Location <String>
    -SapProduct <String>
    -Configuration <String>
    [-SubscriptionId <String>]
    [-EnableSystemAssignedIdentity]
    [-ManagedResourceGroupName <String>]
    [-ManagedResourcesNetworkAccessType <String>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

建立 SAP 解決方案虛擬實例（VIS）資源

範例

範例 1：使用 Virtual Instances for SAP 解決方案部署三層分散式 SAP 系統的基礎架構

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name L46 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayload.json -Tag @{k1 = "v1"; k2 = "v2"} -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：使用 Virtual Instances for 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"} -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 解決方案的虛擬實例，部署三層分散式高可用性（HA） SAP 系統的基礎架構

New-AzWorkloadsSapVirtualInstance -ResourceGroupName 'PowerShell-CLI-TestRG' -Name SK1 -Location eastus -Environment 'NonProd' -SapProduct 'S4HANA' -Configuration .\CreatePayloadHACustomNames.json -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 -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"} -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 解決方案資源（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"} -ManagedResourceGroupName "L46-rg" -ManagedRgStorageAccountName 'acssstoragel46' -ManagedResourcesNetworkAccessType 'Private' -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 -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

中央伺服器的虛擬機器識別碼

參數屬性

類型:	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
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

DefaultProfile 參數無法運作。如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRMContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableSystemAssignedIdentity

決定是否要為資源啟用系統指派的身分識別。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Environment

定義環境類型 - 生產/非生產環境。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-JsonFilePath

提供給建立作業的 Json 檔案路徑

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateViaJsonFilePath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-JsonString

提供給建立作業的 Json 字串

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateViaJsonString

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

資源所在的地理位置

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ManagedResourceGroupName

受控資源組名

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ManagedResourcesNetworkAccessType

受管理資源網路存取類型

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ManagedRgStorageAccountName

在 VIS 部署中建立之受控資源群組中，服務所建立之記憶體帳戶的自定義記憶體帳戶名稱。

請參閱此處的儲存帳戶命名規則。

如果未提供，服務會建立具有隨機名稱的儲存體帳戶

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

「Virtual Instances for SAP solutions」資源的名稱

參數屬性

類型:	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 Product 類型。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubscriptionId

目標訂用帳戶的標識碼。此值必須是 UUID。

參數屬性

類型:	String
預設值:	(Get-AzContext).Subscription.Id
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tag

資源標籤。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UserAssignedIdentity

與資源相關聯的使用者指派身分識別數位。陣組中的元素會是 ARM 資源標識符，格式為：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。'

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

CreateWithDiscovery

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CreateWithJsonTemplatePath

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 (預設值)

CreateViaJsonFilePath

CreateViaJsonString

CreateWithJsonTemplatePath

Description

範例

範例 1： 使用 Virtual Instances for SAP 解決方案部署三層分散式 SAP 系統的基礎架構

範例 2： 使用 Virtual Instances for SAP 解決方案，在針對三層分散式 SAP 系統部署的基礎架構上安裝 SAP 軟體

範例 3： 使用適用於 SAP 解決方案的虛擬實例，部署三層分散式高可用性 （HA） SAP 系統的基礎架構

範例 4： 使用適用於 SAP 解決方案的虛擬實例，在針對三層分散式高可用性 （HA） SAP 系統部署的基礎架構上安裝 SAP 軟體

範例 5：將現有的 SAP 系統註冊為 VIS

範例 6：使用自訂 [受控資源群組] 和 [受控儲存體帳戶名稱] ，以及 [受控儲存體帳戶網路存取類型] 設定，將現有的 SAP 系統註冊為 SAP 解決方案資源 （VIS） 的虛擬執行個體。

範例 7：使用 Azure 計算庫映像部署三層分散式高可用性 （HA） SAP 系統的基礎結構

參數

-AsJob

參數屬性

參數集

-CentralServerVmId

參數屬性

參數集

-Configuration

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EnableSystemAssignedIdentity

參數屬性

參數集

-Environment

參數屬性

參數集

-JsonFilePath

參數屬性

參數集

-JsonString

參數屬性

參數集

-Location

參數屬性

參數集

-ManagedResourceGroupName

參數屬性

參數集

-ManagedResourcesNetworkAccessType

參數屬性

參數集

-ManagedRgStorageAccountName

參數屬性

參數集

-Name

參數屬性

參數集

-NoWait

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-SapProduct

參數屬性

參數集

-SubscriptionId

參數屬性

參數集

-Tag

參數屬性

參數集

-UserAssignedIdentity

參數屬性

參數集

-WhatIf

參數屬性

參數集

範例 1：使用 Virtual Instances for SAP 解決方案部署三層分散式 SAP 系統的基礎架構

範例 2：使用 Virtual Instances for SAP 解決方案，在針對三層分散式 SAP 系統部署的基礎架構上安裝 SAP 軟體

範例 3：使用適用於 SAP 解決方案的虛擬實例，部署三層分散式高可用性（HA） SAP 系統的基礎架構

範例 4：使用適用於 SAP 解決方案的虛擬實例，在針對三層分散式高可用性（HA） SAP 系統部署的基礎架構上安裝 SAP 軟體

範例 6：使用自訂 [受控資源群組] 和 [受控儲存體帳戶名稱] ，以及 [受控儲存體帳戶網路存取類型] 設定，將現有的 SAP 系統註冊為 SAP 解決方案資源（VIS）的虛擬執行個體。

範例 7：使用 Azure 計算庫映像部署三層分散式高可用性（HA） SAP 系統的基礎結構