Invoke-AzStorageSyncChangeDetection

Referencia

Módulo:: Az.StorageSync

Este comando se puede usar para iniciar manualmente la detección de cambios en el espacio de nombres. Se puede destinar a todo el recurso compartido, subcarpeta o conjunto de archivos. Al ejecutar el comando con los parámetros -DirectoryPath o -Path, se puede detectar un máximo de 10 000 elementos. Si se conoce el ámbito de los cambios, limite la ejecución de este comando a partes del espacio de nombres, por lo que la detección de cambios puede finalizar rápidamente y dentro del límite de 10 000 elementos. Como alternativa, puede evitar el límite de elementos ejecutando el cmdlet sin estos parámetros, invocando la detección de cambios de nivel de recurso compartido.

Nota:

Si se ejecuta con parámetros -DirectoryPath o -Path, el comando no detectará los siguientes cambios en el recurso compartido de archivos de Azure:

Archivos que se eliminan.
Archivos que se mueven fuera del recurso compartido.
Archivos que se eliminan y crean con el mismo nombre.

Si se invoca la detección de cambios de nivel de recurso compartido, se detectarán todos estos cambios. Estos cambios también se detectarán cuando se ejecute el trabajo de detección de cambios programado.

Syntax

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>]

Description

Periódicamente, Azure File Sync comprueba el espacio de nombres dentro de un recurso compartido de archivos de Azure sincronizado para ver los cambios que llegaron al recurso compartido de archivos de otro modo que no sea la sincronización. El objetivo es identificar estos cambios y, en última instancia, sincronizarlos con los servidores conectados. Este comando se puede usar para iniciar manualmente la detección de cambios en los espacios de nombres. Se puede destinar a todo el recurso compartido, subcarpeta o conjunto de archivos. Si se conoce el ámbito de los cambios, limite la ejecución de este comando a partes del espacio de nombres, por lo que la detección de cambios de elementos individuales puede finalizar rápidamente y dentro del límite de 10 000 elementos. De lo contrario, ejecute el comando sin los parámetros -DirectoryPath o -Path para invocar la detección completa de cambios de nivel de recurso compartido. El cmdlet Invoke-AzStorageSyncChangeDetection cancelará un trabajo de enumeración de cambios en la nube que está en curso. Para evitar la cancelación de un trabajo actualmente en ejecución, vaya a las propiedades punto de conexión en la nube del portal para comprobar si un trabajo se está ejecutando actualmente.

Ejemplos

Ejemplo 1

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

En este ejemplo, la detección de cambios se ejecuta en los directorios "Data" y "Reporting\Templates" de un recurso compartido de archivos de Azure sincronizado. Todas las rutas de acceso son relativas a la raíz del espacio de nombres del recurso compartido de archivos de Azure.

Ejemplo 2

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

En este ejemplo, se ejecuta la detección de cambios para un conjunto de archivos conocidos para que el autor de la llamada de comando haya cambiado. El objetivo es que Azure File Sync detecte y sincronice estos cambios también.

Ejemplo 3

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

En este ejemplo, la detección de cambios se ejecuta para el directorio "Ejemplos" y detectará de forma recursiva los cambios en los subdirectorios. Tenga en cuenta que el cmdlet producirá un error si la ruta de acceso contiene más de 10 000 elementos. Si la ruta de acceso contiene más de 10 000 elementos, ejecute el comando en las subpartes del espacio de nombres.

Ejemplo 4

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

En este ejemplo, ni -DirectoryPath ni -Path se han pasado al comando . Esto invocará la detección de cambios en todo el recurso compartido de archivos.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DirectoryPath

Directorio en el que se realizará la detección de cambios.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Objeto CloudEndpoint, que normalmente se pasa a través del parámetro .

Tipo:	PSCloudEndpoint
Aliases:	CloudEndpoint
Position:	0
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nombre de CloudEndpoint. El nombre es un GUID, no el nombre descriptivo que se muestra en el portal. Para obtener CloudEndpointName, use el cmdlet Get-AzStorageSyncCloudEndpoint.

Tipo:	String
Aliases:	CloudEndpointName
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

En la ejecución normal, este cmdlet no devuelve ningún valor sobre el éxito. Si proporciona el parámetro PassThru, el cmdlet escribirá un valor en la canalización después de la ejecución correcta.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Ruta de acceso en la que se realizará la detección de cambios.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Recursive

Indicación de si la detección de cambios de directorio es recursiva.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:	String
Position:	0
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Identificador de recurso de CloudEndpoint

Tipo:	String
Aliases:	CloudEndpointId
Position:	0
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageSyncServiceName

Nombre de StorageSyncService.

Tipo:	String
Aliases:	ParentName
Position:	1
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncGroupName

Nombre del SyncGroup.

Tipo:	String
Position:	2
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

PSServerEndpoint

Salidas

Void

Compartir a través de