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.

Sintaxis

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
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

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

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DirectoryPath

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

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

Tipo:	PSCloudEndpoint
Alias:	CloudEndpoint
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	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
Alias:	CloudEndpointName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

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

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Recursive

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceId

Identificador de recurso de CloudEndpoint

Tipo:	String
Alias:	CloudEndpointId
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-StorageSyncServiceName

Nombre de StorageSyncService.

Tipo:	String
Alias:	ParentName
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SyncGroupName

Nombre del SyncGroup.

Tipo:	String
Posición:	2
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

PSServerEndpoint

Salidas

Void

Compartir a través de