New-AzStaticWebApp

參考

模組:: Az.Websites

在現有的資源群組中建立新的靜態網站的描述，或更新現有的靜態網站。

Syntax

New-AzStaticWebApp
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AllowConfigFileUpdate]
   [-ApiBuildCommand <String>]
   [-ApiLocation <String>]
   [-AppArtifactLocation <String>]
   [-AppBuildCommand <String>]
   [-AppLocation <String>]
   [-Branch <String>]
   [-Capacity <Int32>]
   [-GithubActionSecretNameOverride <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-Kind <String>]
   [-OutputLocation <String>]
   [-RepositoryToken <String>]
   [-RepositoryUrl <String>]
   [-SkipGithubActionWorkflowGeneration]
   [-SkuName <String>]
   [-StagingEnvironmentPolicy <StagingEnvironmentPolicy>]
   [-Tag <Hashtable>]
   [-ForkRepositoryDescription <String>]
   [-ForkRepositoryIsPrivate]
   [-ForkRepositoryOwner <String>]
   [-ForkRepositoryName <String>]
   [-TemplateRepositoryUrl <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

在現有的資源群組中建立新的靜態網站的描述，或更新現有的靜態網站。

範例

範例 1：在現有的資源群組中建立新的靜態網站，或更新現有的靜態網站

New-AzStaticWebApp -ResourceGroupName 'azure-rg-test' -Name 'staticweb-45asde' -Location 'Central US' -RepositoryUrl 'https://github.com/LucasYao93/blazor-starter' -RepositoryToken 'githubAccessToken' -Branch 'branch02' -AppLocation 'Client' -ApiLocation 'Api' -OutputLocation 'wwwroot' -SkuName 'Standard'

Kind Location   Name             Type
---- --------   ----             ----
     Central US staticweb-45asde Microsoft.Web/staticSites

此命令會在現有的資源群組中建立新的靜態網站，或更新現有的靜態網站。

範例 2：透過指定的範本存放庫在現有資源群組中建立新的靜態網站

New-AzStaticWebApp -ResourceGroupName 'azure-rg-test' -Name staticweb-pwsh01 -Location "Central US" -RepositoryToken  'xxxxxxxxxxxxxxxxx' -TemplateRepositoryUrl 'https://github.com/staticwebdev/blazor-starter' -ForkRepositoryDescription "Test template repository function of the azure static web." -ForkRepositoryName "test-blazor-starter" -ForkRepositoryOwner 'LucasYao93' -Branch 'main' -AppLocation 'Client' -ApiLocation 'Api' -OutputLocation 'wwwroot' -SkuName 'Standard'

Kind Location   Name             Type
---- --------   ----             ----
     Central US staticweb-pwsh01 Microsoft.Web/staticSites

此命令會在現有的資源群組中建立新的靜態網站，或透過指定的範本存放庫更新現有的靜態網站。

參數

-AllowConfigFileUpdate

<如果此靜態 Web 應用程式鎖定組態檔，則程式代碼為 false/code>，否則為>< true</code。>><

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiBuildCommand

在 Azure Functions API 應用程式部署期間執行的自定義命令。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiLocation

存放庫內 API 程式代碼的路徑。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppArtifactLocation

已淘汰：建置後的應用程式成品路徑（已取代為 OutputLocation）

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppBuildCommand

在部署靜態內容應用程式期間執行的自定義命令。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AppLocation

存放庫內應用程式程式代碼的路徑。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

以作業身分執行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Branch

存放庫中的目標分支。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Capacity

目前指派給資源的實例數目。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForkRepositoryDescription

新產生的存放庫描述。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForkRepositoryIsPrivate

新產生的存放庫是否為私人存放庫。默認為 false （亦即 public）。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForkRepositoryName

新產生的存放庫名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForkRepositoryOwner

新產生的存放庫擁有者。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GithubActionSecretNameOverride

GitHub Action 秘密名稱覆寫。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

受控服務識別的類型。

Type:	ManagedServiceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

與資源相關聯的使用者指派身分識別清單。使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Kind

資源種類。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

資源位置。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

要建立或更新的靜態網站名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

以異步方式執行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OutputLocation

建置後應用程式的輸出路徑。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RepositoryToken

使用者的 github 存放庫令牌。這可用來設定 Github Actions 工作流程檔案和 API 秘密。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RepositoryUrl

靜態網站存放庫的URL。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

資源所屬資源群組的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipGithubActionWorkflowGeneration

略過 Github Action 工作流程產生。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuName

資源 SKU 的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StagingEnvironmentPolicy

指出靜態 Web 應用程式是否允許或不允許預備環境的狀態。

Type:	StagingEnvironmentPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

您的 Azure 訂用帳戶識別碼。這是 GUID 格式的字串（例如 0000000000-0000-0000-0000-0000000000000000）。

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

資源標籤。

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateRepositoryUrl

範本存放庫的 URL。新產生的存放庫將會以此存放庫為基礎。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸出

IStaticSiteArmResource