Partilhar via

Invoke-AzStorageSyncChangeDetection

Módulo:
Az.StorageSync Module

Esse comando pode ser usado para iniciar manualmente a deteção de alterações de namespace. Ele pode ser direcionado para todo o compartilhamento, subpasta ou conjunto de arquivos. Ao executar o comando com os parâmetros -DirectoryPath ou -Path, um máximo de 10.000 itens podem ser detetados. Se o escopo das alterações for conhecido por você, limite a execução desse comando a partes do namespace, para que a deteção de alterações possa ser concluída rapidamente e dentro do limite de 10.000 itens. Como alternativa, você pode evitar o limite de itens executando o cmdlet sem esses parâmetros, invocando a deteção de alterações no nível do compartilhamento.

Observação

Se executado com parâmetros -DirectoryPath ou -Path, o comando não detetará as seguintes alterações no compartilhamento de arquivos do Azure:

  • Arquivos que são excluídos.
  • Arquivos que são movidos para fora do compartilhamento.
  • Arquivos excluídos e criados com o mesmo nome.

Se a deteção de alterações no nível de compartilhamento for invocada, todas essas alterações serão detetadas. Essas alterações também serão detetadas quando o trabalho de deteção de alterações agendado for executado.

Sintaxe

FullShareStringParameterSet (Predefinição) 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareResourceIdParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareObjectParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Periodicamente, o Azure File Sync verifica o namespace dentro de um compartilhamento de arquivos do Azure sincronizando em busca de alterações que entraram no compartilhamento de arquivos por outros meios que não a sincronização. O objetivo é identificar essas alterações e, finalmente, sincronizá-las com servidores conectados. Este comando pode ser usado para iniciar manualmente a deteção de alterações de namespaces. Ele pode ser direcionado para todo o compartilhamento, subpasta ou conjunto de arquivos. Se o escopo das alterações for conhecido por você, limite a execução desse comando a partes do namespace, para que a deteção de alterações de itens individuais possa ser concluída rapidamente e dentro do limite de 10.000 itens. Caso contrário, execute o comando sem os parâmetros -DirectoryPath ou -Path para invocar a deteção completa de alterações no nível do compartilhamento. O cmdlet Invoke-AzStorageSyncChangeDetection cancelará um trabalho de enumeração de alteração na nuvem que está em andamento. Para evitar o cancelamento de um trabalho em execução no momento, vá para as propriedades do Cloud Endpoint no portal para verificar se um trabalho está em execução no momento.

Exemplos

Exemplo 1

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

Neste exemplo, a deteção de alterações é executada nos diretórios "Dados" e "Relatórios\Modelos" de um compartilhamento de arquivos do Azure sincronizado. Todos os caminhos são relativos à raiz do namespace de compartilhamento de arquivos do Azure.

Exemplo 2

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

Neste exemplo, a deteção de alterações é executada para um conjunto de arquivos que são conhecidos pelo chamador de comando como alterados. O objetivo é fazer com que a sincronização de arquivos do Azure também detete e sincronize essas alterações.

Exemplo 3

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

Neste exemplo, a deteção de alterações é executada para o diretório "Exemplos" e detetará recursivamente alterações em subdiretórios. Lembre-se de que o cmdlet falhará se o caminho contiver mais de 10.000 itens. Se o caminho contiver mais de 10.000 itens, execute o comando em subpartes do namespace.

Exemplo 4

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

Neste exemplo, nem -DirectoryPath nem -Path foram passados para o comando. Isso invocará a deteção de alterações em todo o compartilhamento de arquivos.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DirectoryPath

Diretório onde a deteção de alterações será realizada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

StringAndDirectoryParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ResourceIdAndDirectoryParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ObjectAndDirectoryParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

CloudEndpoint Object, normalmente passado através do parâmetro.

Propriedades dos parâmetros

Tipo:PSCloudEndpoint
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:CloudEndpoint

Conjuntos de parâmetros

ObjectAndDirectoryParameterSet
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ObjectAndPathParameterSet
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
FullShareObjectParameterSet
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Nome do CloudEndpoint. O nome é um GUID, não o nome amigável exibido no portal. Para obter o CloudEndpointName, use o cmdlet Get-AzStorageSyncCloudEndpoint.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:CloudEndpointName

Conjuntos de parâmetros

FullShareStringParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndDirectoryParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndPathParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

Na execução normal, esse cmdlet não retorna nenhum valor em caso de êxito. Se você fornecer o parâmetro PassThru, o cmdlet gravará um valor no pipeline após a execução bem-sucedida.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Path

Caminho onde a deteção de alterações será executada.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

StringAndPathParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ResourceIdAndPathParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ObjectAndPathParameterSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Recursive

Indicação se a deteção de alteração de diretório é recursiva.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

StringAndDirectoryParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ResourceIdAndDirectoryParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ObjectAndDirectoryParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FullShareStringParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndDirectoryParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndPathParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceId

ID do recurso do CloudEndpoint

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:CloudEndpointId

Conjuntos de parâmetros

ResourceIdAndDirectoryParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ResourceIdAndPathParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
FullShareResourceIdParameterSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StorageSyncServiceName

Nome do StorageSyncService.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome dos pais

Conjuntos de parâmetros

FullShareStringParameterSet
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndDirectoryParameterSet
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndPathParameterSet
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SyncGroupName

Nome do SyncGroup.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FullShareStringParameterSet
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndDirectoryParameterSet
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
StringAndPathParameterSet
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSServerEndpoint

Saídas

Void