你当前正在访问 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-Az存储SyncChangeDetection 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

Type:	SwitchParameter
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:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectoryPath

将执行更改检测的目录。

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

-InputObject

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

Type:	PSCloudEndpoint
Aliases:	CloudEndpoint
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

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

-PassThru

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

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

-Path

将执行更改检测的路径。

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

-Recursive

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

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

-ResourceGroupName

资源组名称。

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

-ResourceId

CloudEndpoint 资源 ID

Type:	String
Aliases:	CloudEndpointId
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageSyncServiceName

存储SyncService 的名称。

Type:	String
Aliases:	ParentName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncGroupName

SyncGroup 的名称。

Type:	String
Position:	2
Default value:	None
Required:	True
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

输入

String

PSServerEndpoint

输出

Void