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

Invoke-AzStorageSyncChangeDetection

此命令可用于手动启动命名空间更改检测。 它可以面向整个共享、子文件夹或文件集。 使用 -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 参数的命令以调用完整的共享级更改检测。

示例

示例 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
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DirectoryPath

将执行更改检测的目录。

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

-InputObject

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

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

-Name

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

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

-PassThru

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

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

-Path

将执行更改检测的路径。

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

-Recursive

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

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

-ResourceGroupName

资源组名称。

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

-ResourceId

CloudEndpoint 资源 ID

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

-StorageSyncServiceName

StorageSyncService 的名称。

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

-SyncGroupName

SyncGroup 的名称。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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

输入

String

PSServerEndpoint

输出

Void