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

Invoke-AzStorageSyncChangeDetection

参考

模块:: Az.StorageSync

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

注释

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

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

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

语法

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

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

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

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

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

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

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

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

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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DirectoryPath

将执行更改检测的目录。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

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

类型:	PSCloudEndpoint
别名:	CloudEndpoint
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

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

类型:	String
别名:	CloudEndpointName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PassThru

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Path

将执行更改检测的路径。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Recursive

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceId

CloudEndpoint 资源 ID

类型:	String
别名:	CloudEndpointId
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StorageSyncServiceName

StorageSyncService 的名称。

类型:	String
别名:	ParentName
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SyncGroupName

SyncGroup 的名称。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

PSServerEndpoint

输出

Void