Invoke-AzStorageSyncChangeDetection

Référence

Module:: Az.StorageSync

Cette commande peut être utilisée pour lancer manuellement la détection des modifications d’espace de noms. Il peut être ciblé sur l’ensemble du partage, du sous-dossier ou de l’ensemble de fichiers. Lorsque vous exécutez la commande avec les paramètres -DirectoryPath ou -Path, un maximum de 10 000 éléments peut être détecté. Si l’étendue des modifications est connue pour vous, limitez l’exécution de cette commande à des parties de l’espace de noms, afin que la détection des modifications puisse se terminer rapidement et dans la limite de 10 000 éléments. Vous pouvez également éviter la limite d’élément en exécutant l’applet de commande sans ces paramètres, en appelant la détection des modifications au niveau du partage.

Remarque

Si vous exécutez avec les paramètres -DirectoryPath ou -Path, la commande ne détecte pas les modifications suivantes dans le partage de fichiers Azure :

Fichiers supprimés.
Fichiers déplacés hors du partage.
Fichiers supprimés et créés avec le même nom.

Si la détection des modifications au niveau du partage est appelée, toutes ces modifications sont détectées. Ces modifications sont également détectées lorsque le travail de détection des modifications planifié s’exécute.

Syntaxe

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

Régulièrement, Azure File Sync vérifie l’espace de noms à l’intérieur d’un partage de fichiers Azure synchronisé pour les modifications apportées au partage de fichiers par d’autres moyens que la synchronisation. L’objectif est d’identifier ces modifications et finalement de les synchroniser avec des serveurs connectés. Cette commande peut être utilisée pour lancer manuellement la détection des modifications d’espaces de noms. Il peut être ciblé sur l’ensemble du partage, du sous-dossier ou de l’ensemble de fichiers. Si l’étendue des modifications est connue pour vous, limitez l’exécution de cette commande à des parties de l’espace de noms, afin que la détection des modifications d’élément individuelles puisse se terminer rapidement et dans la limite de 10 000 éléments. Sinon, exécutez la commande sans les paramètres -DirectoryPath ou -Path pour appeler la détection complète des modifications au niveau du partage. L’applet de commande Invoke-AzStorageSyncChangeDetection annule un travail d’énumération de modification cloud en cours. Pour éviter d’annuler un travail en cours d’exécution, accédez aux propriétés du point de terminaison cloud dans le portail pour vérifier si un travail est en cours d’exécution.

Exemples

Exemple 1

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

Dans cet exemple, la détection des modifications est exécutée dans les répertoires « Données » et « Reporting\Templates » d’un partage de fichiers Azure synchronisé. Tous les chemins sont relatifs à la racine de l’espace de noms du partage de fichiers Azure.

Exemple 2

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

Dans cet exemple, la détection des modifications est exécutée pour un ensemble de fichiers connus de l’appelant de commande pour avoir changé. L’objectif est d’avoir la synchronisation de fichiers Azure détecter et synchroniser ces modifications également.

Exemple 3

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

Dans cet exemple, la détection des modifications est exécutée pour le répertoire « Exemples » et détecte de manière récursive les modifications dans les sous-répertoires. N’oubliez pas que l’applet de commande échoue si le chemin contient plus de 10 000 éléments. Si le chemin contient plus de 10 000 éléments, exécutez la commande sur les sous-parties de l’espace de noms.

Exemple 4

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

Dans cet exemple, ni -DirectoryPath ni -Path n’a été passé à la commande. Cela appelle la détection des modifications sur l’ensemble du partage de fichiers.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DirectoryPath

Répertoire dans lequel la détection des modifications sera effectuée.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Objet CloudEndpoint, normalement passé par le paramètre.

Type:	PSCloudEndpoint
Alias:	CloudEndpoint
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Nom du CloudEndpoint. Le nom est un GUID, et non le nom convivial affiché dans le portail. Pour obtenir CloudEndpointName, utilisez l’applet de commande Get-AzStorageSyncCloudEndpoint.

Type:	String
Alias:	CloudEndpointName
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PassThru

Dans l’exécution normale, cette applet de commande ne retourne aucune valeur en cas de réussite. Si vous fournissez le paramètre PassThru, l’applet de commande écrit une valeur dans le pipeline après l’exécution réussie.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Path

Chemin d’accès où la détection des modifications sera effectuée.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Recursive

Indique si la détection des modifications de répertoire est récursive.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceId

ID de ressource CloudEndpoint

Type:	String
Alias:	CloudEndpointId
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-StorageSyncServiceName

Nom du StorageSyncService.

Type:	String
Alias:	ParentName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SyncGroupName

Nom du SyncGroup.

Type:	String
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

PSServerEndpoint

Sorties

Void

Partager via