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

Invoke-AzStorageSyncChangeDetection

模块:: Az.StorageSync Module

此命令可用于手动启动命名空间更改检测。它可以面向整个共享、子文件夹或一组文件。使用 -DirectoryPath 或 -Path 参数运行命令时，最多可以检测到 10,000 个项。如果已知更改范围，请将此命令的执行限制为命名空间的一部分，因此更改检测可以快速完成，并在 10,000 项限制内完成。或者，可以通过运行不带这些参数的 cmdlet 来避免项限制，从而调用共享级更改检测。

注释

如果使用 -DirectoryPath 或 -Path 参数运行，该命令将不会检测 Azure 文件共享中的以下更改：

已删除的文件。
移出共享的文件。
删除并创建具有相同名称的文件。

如果调用共享级更改检测，将检测所有这些更改。当计划的更改检测作业运行时，也会检测这些更改。

语法

FullShareStringParameterSet （默认值）

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndDirectoryParameterSet

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndPathParameterSet

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndDirectoryParameterSet

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndPathParameterSet

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareResourceIdParameterSet

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndDirectoryParameterSet

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndPathParameterSet

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareObjectParameterSet

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

定期，Azure 文件同步检查同步 Azure 文件共享中的命名空间，以其他方式（而不是同步）进入文件共享中的更改。目标是确定这些更改，并最终将它们同步到连接的服务器。此命令可用于手动启动命名空间更改检测。它可以面向整个共享、子文件夹或一组文件。如果已知更改范围，请将此命令的执行限制为命名空间的一部分，因此单个项更改检测可以快速完成，并在 10,000 个项目限制内完成。否则，请运行不带 -DirectoryPath 或 -Path 参数的命令，以调用完整的共享级更改检测。 Invoke-AzStorageSyncChangeDetection cmdlet 将取消正在进行的云更改枚举作业。若要避免取消当前正在运行的作业，请转到门户中的云终结点属性，检查作业当前是否正在运行。

示例

示例 1

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"

在此示例中，更改检测在同步 Azure 文件共享的“Data”和“Reporting\Templates”目录中运行。所有路径都相对于 Azure 文件共享命名空间的根目录。

示例 2

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"

在此示例中，更改检测针对命令调用方已知已更改的一组文件运行。目标是让 Azure 文件同步检测和同步这些更改。

示例 3

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive

在此示例中，更改检测针对“示例”目录运行，并将以递归方式检测子目录中的更改。请记住，如果路径包含 10,000 个以上的项，cmdlet 将失败。如果路径包含 10,000 个以上的项，请在命名空间的子部分上运行命令。

示例 4

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"

在此示例中，未将 -DirectoryPath 和 -Path 传递给命令。这将对整个文件共享调用更改检测。

参数

-AsJob

在后台运行 cmdlet

参数属性

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

参数集

(All)

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

-Confirm

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

参数属性

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

参数集

(All)

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-DirectoryPath

将执行更改检测的目录。

参数属性

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

参数集

StringAndDirectoryParameterSet

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

ResourceIdAndDirectoryParameterSet

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

ObjectAndDirectoryParameterSet

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

-InputObject

CloudEndpoint 对象，通常通过参数传递。

参数属性

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

参数集

ObjectAndDirectoryParameterSet

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

ObjectAndPathParameterSet

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

FullShareObjectParameterSet

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

-Name

CloudEndpoint 的名称。该名称是 GUID，而不是门户中显示的友好名称。若要获取 CloudEndpointName，请使用 Get-AzStorageSyncCloudEndpoint cmdlet。

参数属性

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

参数集

FullShareStringParameterSet

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

StringAndDirectoryParameterSet

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

StringAndPathParameterSet

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

-PassThru

在正常执行中，此 cmdlet 在成功时不返回任何值。如果提供 PassThru 参数，则 cmdlet 会在成功执行后将值写入管道。

参数属性

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

参数集

(All)

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

-Path

将执行更改检测的路径。

参数属性

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

参数集

StringAndPathParameterSet

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

ResourceIdAndPathParameterSet

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

ObjectAndPathParameterSet

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

-Recursive

指示目录更改检测是否递归。

参数属性

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

参数集

StringAndDirectoryParameterSet

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

ResourceIdAndDirectoryParameterSet

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

ObjectAndDirectoryParameterSet

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

-ResourceGroupName

资源组名称。

参数属性

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

参数集

FullShareStringParameterSet

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

StringAndDirectoryParameterSet

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

StringAndPathParameterSet

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

-ResourceId

CloudEndpoint 资源 ID

参数属性

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

参数集

ResourceIdAndDirectoryParameterSet

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

ResourceIdAndPathParameterSet

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

FullShareResourceIdParameterSet

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

-StorageSyncServiceName

StorageSyncService 的名称。

参数属性

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

参数集

FullShareStringParameterSet

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

StringAndDirectoryParameterSet

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

StringAndPathParameterSet

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

-SyncGroupName

SyncGroup 的名称。

参数属性

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

参数集

FullShareStringParameterSet

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

StringAndDirectoryParameterSet

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

StringAndPathParameterSet

Position:	2
必需:	True
来自管道的值:	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。

通过

Invoke-AzStorageSyncChangeDetection

语法

FullShareStringParameterSet （默认值）

StringAndDirectoryParameterSet

StringAndPathParameterSet

ResourceIdAndDirectoryParameterSet

ResourceIdAndPathParameterSet

FullShareResourceIdParameterSet

ObjectAndDirectoryParameterSet

ObjectAndPathParameterSet

FullShareObjectParameterSet

说明

示例

示例 1

示例 2

示例 3

示例 4

参数

-AsJob

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DirectoryPath

参数属性

参数集

-InputObject

参数属性

参数集

-Name

参数属性

参数集

-PassThru

参数属性

参数集

-Path

参数属性

参数集

-Recursive

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ResourceId

参数属性

参数集

-StorageSyncServiceName

参数属性

参数集

-SyncGroupName

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

PSServerEndpoint

输出

Void

反馈