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

Azure Az PowerShell 中即将推出的中断性变更

  • 项目

常规

Az.Accounts

Clear-AzConfig

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将弃用参数 DisableErrorRecordsPersistence，并会添加一个新参数 EnableErrorRecordsPersistence。 将错误记录写入文件系统将变为选择加入而不是选择退出。此更改将在 2024 年 5 月左右发生
    • 此更改预计将从 Az.Accounts 版本 2.X 和 Az 版本 12.0.0 开始生效

Get-AzConfig

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将弃用参数 DisableErrorRecordsPersistence，并会添加一个新参数 EnableErrorRecordsPersistence。 将错误记录写入文件系统将变为选择加入而不是选择退出。此更改将在 2024 年 5 月左右发生
    • 此更改预计将从 Az.Accounts 版本 2.X 和 Az 版本 12.0.0 开始生效

Update-AzConfig

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将弃用参数 DisableErrorRecordsPersistence，并会添加一个新参数 EnableErrorRecordsPersistence。 将错误记录写入文件系统将变为选择加入而不是选择退出。此更改将在 2024 年 5 月左右发生
    • 此更改预计将从 Az.Accounts 版本 2.X 和 Az 版本 12.0.0 开始生效

Az.CosmosDB

Get-AzCosmosDBAccountKey

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 在下一个主版本中，-Type ConnectionStrings 的输出类型将更改为 List<DatabaseAccountConnectionString>。
    • 此更改预计将从 Az.CosmosDB 版本 2.0.0 和 Az 版本 12.0.0 开始生效

Az.KeyVault

Invoke-AzKeyVaultKeyOperation

  • 所有参数集都将发生 Cmdlet 中断性变更

    • 将更改输出类型“Microsoft.Azure.Commands.KeyVault.Models.PSKeyOperationResult”
    • 将弃用输出类型中的以下属性：“Result”
    • 以下属性将添加到输出类型：“RawResult”
    • 此更改预计将从 Az.KeyVault 版本 6.0.0 和 Az 版本 12.0.0 开始生效

  • 所有参数集都将发生参数中断性变更

    • -Value
      • 参数“Value”将替换为参数“ByteArrayValue”。
      • 此更改预计将从 Az.KeyVault 版本 6.0.0 和 Az 版本 12.0.0 开始生效

Az.RecoveryServices

Get-AzRecoveryServicesAsrVaultContext

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRVaultSettings”正在更改
    • 将弃用此输出类型中的以下属性：ResouceType
    • 将向此输出类型中添加以下属性：ResourceType
    • 此更改预计将从 Az.RecoveryServices 版本 7.0.0 和 Az 版本 12.0.0 开始生效

Import-AzRecoveryServicesAsrVaultSettingsFile

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRVaultSettings”正在更改
    • 将弃用此输出类型中的以下属性：ResouceType
    • 将向此输出类型中添加以下属性：ResourceType
    • 此更改预计将从 Az.RecoveryServices 版本 7.0.0 和 Az 版本 12.0.0 开始生效

Set-AzRecoveryServicesAsrVaultContext

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRVaultSettings”正在更改
    • 将弃用此输出类型中的以下属性：ResouceType
    • 将向此输出类型中添加以下属性：ResourceType
    • 此更改预计将从 Az.RecoveryServices 版本 7.0.0 和 Az 版本 12.0.0 开始生效

Az.Resources

Get-AzPolicyAssignment

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将更改输出类型 Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyAssignment
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“EnforcementMode”、“Metadata”、“NonComplianceMessages”、“NotScopes”、“Parameters”、“PolicyDefinitionId”、“Scope”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Get-AzPolicyDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Mode”、“Parameters”、“PolicyRule”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Get-AzPolicyExemption

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyExemption”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“ExemptionCategory”、“ExpiresOn”、“Metadata”、“PolicyAssignmentId”、“PolicyDefinitionReferenceIds”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Get-AzPolicySetDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicySetDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Parameters”、“PolicyDefinitionGroups”、“PolicyDefinitions”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

New-AzPolicyAssignment

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将更改输出类型 Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyAssignment
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“EnforcementMode”、“Metadata”、“NonComplianceMessages”、“NotScopes”、“Parameters”、“PolicyDefinitionId”、“Scope”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

New-AzPolicyDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Mode”、“Parameters”、“PolicyRule”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

New-AzPolicyExemption

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyExemption”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“ExemptionCategory”、“ExpiresOn”、“Metadata”、“PolicyAssignmentId”、“PolicyDefinitionReferenceIds”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

New-AzPolicySetDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicySetDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Parameters”、“PolicyDefinitionGroups”、“PolicyDefinitions”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Set-AzPolicyAssignment

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 将更改输出类型 Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyAssignment
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“EnforcementMode”、“Metadata”、“NonComplianceMessages”、“NotScopes”、“Parameters”、“PolicyDefinitionId”、“Scope”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Set-AzPolicyDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Mode”、“Parameters”、“PolicyRule”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Set-AzPolicyExemption

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyExemption”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“ExemptionCategory”、“ExpiresOn”、“Metadata”、“PolicyAssignmentId”、“PolicyDefinitionReferenceIds”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Set-AzPolicySetDefinition

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 输出类型“Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicySetDefinition”即将发生更改
    • 将弃用输出类型中的以下属性：“Properties”
    • 以下属性将添加到输出类型：“Description”、“DisplayName”、“Metadata”、“Parameters”、“PolicyDefinitionGroups”、“PolicyDefinitions”、“PolicyType”
    • 此更改预计将从 Az.Resources 版本 7.1.0 和 Az 版本 12.0.0 开始生效

Az.Sql

New-AzSqlDatabaseFailoverGroup

  • 所有参数集都将发生 Cmdlet 中断性变更
    • FailoverPolicy 的默认值将从 Automatic 更改为 Manual
    • 此更改预计将从 Az.Sql 版本 5.0.0 和 Az 版本 12.0.0 开始生效

Set-AzSqlDatabaseFailoverGroup

  • 所有参数集都将发生 Cmdlet 中断性变更
    • FailoverPolicy 的默认值将从 Automatic 更改为 Manual
    • 此更改预计将从 Az.Sql 版本 5.0.0 和 Az 版本 12.0.0 开始生效

Az.Storage

Get-AzStorageQueue

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 已弃用的 v11 SDK 中的子属性 CloudQueue 和 EncodeMessage 将被删除。 使用子属性 QueueClient 替代 CloudQueue。
    • 此更改预计将从 Az.Storage 版本 6.0.0 和 Az 版本 11.0.0 开始生效

New-AzStorageQueue

  • 所有参数集都将发生 Cmdlet 中断性变更
    • 已弃用的 v11 SDK 中的子属性 CloudQueue 和 EncodeMessage 将被删除。 使用子属性 QueueClient 替代 CloudQueue。
    • 此更改预计将从 Az.Storage 版本 6.0.0 和 Az 版本 11.0.0 开始生效

New-AzStorageQueueSASToken

  • 所有参数集都将发生参数中断性变更
    • -Protocol
      • 参数协议的类型将从 SharedAccessProtocol 更改为字符串。
      • 此更改预计将从 Az.Storage 版本 7.0.0 和 Az 版本 12.0.0 开始生效

Set-AzStorageAccount

  • 所有参数集都将发生参数中断性变更
    • -UpgradeToStorageV2
      • 将存储帐户从 StorageV1 或 BlobStorage 升级到 StorageV2 时，将添加需要用户确认的提示。 使用 -Force 可以禁止显示该提示。
      • 此更改预计将从 Az.Storage 版本 7.0.0 和 Az 版本 12.0.0 开始生效

Set-AzStorageFileContent

  • 所有参数集都将发生参数中断性变更
    • -Path
      • 在使用没有读取权限的 SAS 令牌上传时，目标路径将用作文件路径，而不是先前的目录路径。
      • 此更改预计将从 Az.Storage 版本 7.0.0 和 Az 版本 12.0.0 开始生效