기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 스토리지 보고서
스토리지 보고서는 파일 시스템 사용량에 대한 자세한 분석을 제공하여 스토리지가 사용되는 방식을 이해하고, 보관 또는 삭제할 수 있는 파일을 식별하고, 파일 관리 정책 준수를 모니터링하는 데 도움이 됩니다. 파일 소유권, 파일 유형, 중복 파일, 대용량 파일, 파일 검사 및 할당량 사용량을 분석하는 여러 유형의 보고서를 생성할 수 있습니다.
## 보고서 유형
다음과 같은 보고서 유형을 생성할 수 있습니다.
+ `DuplicateFiles`
파일 크기와 해시 비교를 기반으로 콘텐츠가 동일한 파일을 식별합니다. 이 보고서를 사용하여 불필요한 스토리지 공간을 소비하는 중복 파일을 찾습니다. 보고서는 중복 파일을 그룹화하고 중복 파일을 제거하여 복구할 수 있는 총 공간을 표시합니다.
+ `FilesByFileGroup`
파일 그룹 멤버십을 기준으로 [파일을](fsrm-file-groups.md) 그룹화하고 각 파일 그룹의 스토리지 사용량을 표시합니다. 이 보고서를 사용하여 스토리지 공간을 가장 많이 소비하는 파일 유형(문서, 미디어, 실행 파일 등)을 파악할 수 있습니다.
+ `FilesByOwner`
소유자별로 파일을 그룹화하고 각 사용자 또는 그룹이 소비하는 스토리지의 양을 표시합니다. 이 보고서를 사용하여 스토리지 공간을 가장 많이 소비하는 사용자를 식별하고 스토리지 비용 또는 할당량을 적절하게 할당할 수 있습니다.
+ `FilesByProperty`
분류 속성 값을 기준으로 파일을 그룹화하고 각 속성 값에 대한 파일 수 및 스토리지 소비를 표시합니다. 이 보고서를 사용하여 데이터 민감도 수준, 부서 또는 보존 기간과 같은 분류를 기반으로 파일을 분석할 수 있습니다. 이 보고서에는를 사용하여 파일을 분류해야 합니다[분류 규칙](fsrm-file-classification.md#fsrm-classification-rules).
+ `FileScreenAuditFiles`
사용자가 활성 파일 화면에 의해 차단된 파일을 저장하려고 시도한 [파일 검사](fsrm-file-screening.md) 위반을 나열합니다. 이 보고서를 사용하여 파일 검사 정책 준수를 모니터링하고 승인되지 않은 파일 유형을 저장하려고 자주 시도하는 사용자를 식별할 수 있습니다.
+ `FoldersByProperty`
관리 속성 값을 기준으로 폴더를 그룹화하고 각 속성 값에 대한 스토리지 소비를 표시합니다. 이 보고서를 사용하여 사용자 파일, 그룹 공유 또는 애플리케이션 파일과 같은 폴더 용도별로 스토리지 사용량을 분석할 수 있습니다.
+ `LargeFiles`
지정된 크기 임계값을 초과하는 파일을 나열합니다. 이 보고서를 사용하여 상당한 스토리지 공간을 소비하고 아카이브, 압축 또는 삭제 대상이 될 수 있는 파일을 식별할 수 있습니다.
+ `LeastRecentlyAccessed`
지정된 일수 동안 액세스하지 않은 파일을 나열합니다. 이 보고서를 사용하여 보관하거나 저비용 스토리지 계층으로 이동할 수 있는 비활성 파일을 식별합니다.
+ `MostRecentlyAccessed`
지정된 일수 내에 액세스한 파일을 나열합니다.
+ `QuotaUsage`
할당량이 구성된 폴더에 대한 [할당량 사용량 통계를](fsrm-quota-management.md) 표시합니다. 이 보고서를 사용하여 할당량 규정 준수를 모니터링하고 할당량 한도에 근접한 폴더를 식별할 수 있습니다.
## 보고서 형식
다양한 사용 사례에 맞게 여러 형식으로 보고서를 생성할 수 있습니다.
+ `DHTML` - 정렬 및 필터링과 같은 대화형 기능이 있는 동적 HTML 형식입니다.
+ `HTML` - 아카이빙 또는 이메일 전송에 적합한 정적 HTML 형식입니다.
+ `XML` - 프로그래밍 처리를 위한 구조화된 데이터 형식입니다.
+ `CSV` - 스프레드시트 애플리케이션으로 가져오기 위한 쉼표로 구분된 값 형식입니다.
+ `Text` - 간단한 보기 또는 처리를 위한 일반 텍스트 형식입니다.
단일 보고서에 여러 형식을 지정할 수 있습니다.
## 대화형 및 예약된 보고서
두 가지 유형의 스토리지 보고서를 생성할 수 있습니다.
1. **대화형 보고서** - 생성 시 즉시 실행하고 한 번만 실행합니다. 임시 분석 또는 문제 해결을 위해 대화형 보고서를 사용합니다. 대화형 보고서에는 일정이 없으며 생성 후에는 수정할 수 없습니다. 다른 대화형 보고서를 실행하려면 다른 이름으로 새 보고서를 생성해야 합니다.
1. **예약된 보고서** - 구성된 일정에 따라 자동으로 실행됩니다. 정기 모니터링 및 규정 준수 보고를 위해 예약된 보고서를 사용합니다. 보고서를 매주 또는 매월 특정 시간에 실행하도록 예약할 수 있습니다. 예약된 보고서를 수정하여 구성을 변경할 수 있으며 예약된 시간을 기다리지 않고 [Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport) 명령을 사용하여 온디맨드 방식으로 실행할 수도 있습니다.
## 보고서 실행
예약된 보고서를 생성한 후 여러 가지 방법으로 실행할 수 있습니다.
+ **자동 실행** - 예약된 보고서는 구성된 예약 시간에 자동으로 실행됩니다.
+ **수동 실행** - 예약된 보고서를 예약된 시간 동안 기다리지 않고 온디맨드로 실행하는 [Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport) 데 사용합니다.
를 사용하여 보고서 실행을 모니터링[Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport)하여 상태를 확인할 수 있습니다.
## 스토리지 보고서 액세스
FSRM이 스토리지 보고서를 생성한 후 보고서 파일은 파일 시스템의 기본 위치에 저장됩니다. 이러한 보고서에 액세스하려면 파일 시스템의 관리 D\$1 공유를 매핑해야 합니다.
**스토리지 보고서에 액세스하려면**
1. 다음 경로 형식을 사용하여 관리 D\$1 공유를 매핑합니다.
```
\\file-system-dns-name\D$
```
예제:
```
\\amznfsxaa11bb22.corp.example.com\D$
```
1. StorageReports 폴더로 이동합니다. 이 폴더에는 보고서 유형 및 실행 날짜별로 구성된 하위 폴더가 포함되어 있습니다.
**참고**
관리 D\$1 공유에 액세스하려면 관리자 자격 증명이 필요합니다.
## 스토리지 보고서 모범 사례
효율적이고 효과적인 스토리지 보고를 보장하려면 다음 모범 사례를 따르세요.
### 성능 고려 사항
FSRM은 대량의 파일을 스캔해야 하므로 스토리지 보고서 생성은 리소스 집약적입니다.
+ **보고서 범위 제한** - 파라미터를 사용하여 전체 파일 시스템을 스캔하는 대신 보고서를 특정 폴더로 `Namespace` 제한합니다. 큰 디렉터리 구조 스캔은 리소스 집약적이며 완료하는 데 몇 시간이 걸릴 수 있습니다.
+ **사용량이 적은 시간에 보고서 예약** - 시스템 활동이 적은 기간 동안 예약된 보고서를 실행하여 성능에 미치는 영향을 최소화합니다. 백업 기간 또는 기타 유지 관리 작업 중에 보고서를 실행하지 마십시오.
+ **적절한 임계값 설정** - 임계값 파라미터를 사용하여 보고서 출력을 실행 가능한 데이터로 제한합니다. 예를 들어 `LargeFileMinimum`를 1MB를 초과하는 모든 파일이 아니라 조사할 파일을 식별하는 값으로 설정합니다.
+ **RunDuration 제한 사용** - 보고서가 너무 오래 실행되어 시스템 성능에 영향을 주지 않도록 `RunDuration` 파라미터를 설정합니다. 보고서가 시간 제한 내에 완료되지 않으면 예약된 다음 실행 중에 재개됩니다.
+ **보고서 성능 모니터링** - 보고서를 완료하는 [Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport) 데 걸리는 시간을 확인하는 데 사용합니다. 보고서가 지속적으로 너무 오래 걸리는 경우 범위를 좁히거나 자주 실행하지 않는 것이 좋습니다.
### 보고서 설계
+ **설명 이름 사용** - "주간 대용량 파일 - 재무 공유" 또는 "월별 중복 파일 - 모든 공유"와 같이 분석 대상과 실행 시기를 나타내는 명확하고 설명적인 이름을 보고서에 제공합니다.
+ **관련 분석 결합** - 동일한 네임스페이스에 대해 여러 보고서 유형을 생성하는 경우 별도의 보고서가 아닌 여러 `ReportType` 값으로 단일 보고서를 생성합니다. 이는 FSRM이 디렉터리 구조를 한 번만 스캔하면 되므로 더 효율적입니다.
+ **파일 패턴별 필터링** - 파일 패턴 파라미터를 사용하여 보고서를 특정 파일 유형에 집중합니다. 예를 들어 대용량 파일을 분석할 때 비디오 파일, 데이터베이스 파일 및 아카이브 파일에 대한 별도의 보고서를 생성하여 스토리지 소비 패턴을 더 잘 이해할 수 있습니다.
+ **분류 속성 활용** - `FilesByProperty` 보고서를 사용하여 분류에 따라 파일을 분석합니다. 이렇게 하면 더 의미 있는 인사이트를 얻을 수 있습니다.
### 보고서 관리
+ **보고서 정기 검토** - 보고서 결과를 검토하고 결과에 대한 조치를 취할 시간을 예약합니다. 보고서는 스토리지 관리 결정을 내리는 데 사용하는 경우에만 유용합니다.
+ **이전 보고서 보관** - 보고서 파일은 시간이 지남에 따라 누적되어 스토리지 공간을 소비합니다. 보고서 파일에 대한 보존 정책을 설정하고 더 이상 필요하지 않은 이전 보고서를 삭제하거나 보관합니다.
+ **예약 전 테스트 보고서** - 대화형 보고서를 생성하여 보고서 구성을 테스트하고 예약된 버전을 생성하기 전에 예상 결과를 생성하는지 확인합니다.
## 스토리지 보고서 관리 명령
스토리지 보고서를 관리하기 위해 두 가지 FSx 원격 PowerShell 명령 패밀리에 액세스할 수 있습니다.
1. **보고서 정의 명령** - 분석할 데이터, 보고서를 실행할 시기 및 생성할 형식을 지정하는 스토리지 보고서 구성을 생성, 검색, 수정 및 제거합니다.
1. **보고서 실행 명령** - 스토리지 보고서 생성을 시작, 중지, 모니터링 및 기다립니다. 이러한 명령을 사용하여 온디맨드 방식으로 보고서를 실행하거나 장기 실행 보고서 작업을 관리할 수 있습니다.
### Storage Report FSx 원격 PowerShell 명령 목록
**참고**
이 페이지의 모든 예제에서는 파일 시스템의 Windows 원격 PowerShell 엔드포인트로 ` $FSxWindowsRemotePowerShellEndpoint` 변수를 정의했다고 가정합니다. 파일 시스템의 세부 정보 페이지의 Amazon FSx 콘솔에서 또는 명령을 사용하여이 엔드포인트를 AWS CLI `describe-file-systems` 찾을 수 있습니다.
### 보고서 정의 명령
#### New-FSxFSRMStorageReport
**New-FSxFSRMStorageReport**: 지정된 디렉터리를 분석하여 하나 이상의 보고서 유형을 생성하는 스토리지 보고서를 생성합니다.
**파라미터:**
+ `Name (string)` - 필수 항목입니다. 스토리지 보고서의 이름입니다.
+ `Namespace (array)` - 필수 항목입니다. 분석할 경로 또는 폴더 유형의 배열입니다. 경로를 여러 형식으로 지정할 수 있습니다.
+ 폴더 경로
+ [폴더 분류](fsrm-file-classification.md#fsrm-management-properties). 예: [FolderUsage\$1MS="User Files"]
+ `ReportType (array)` - 필수 항목입니다. 생성할 보고서 유형의 배열입니다. 다음 값을 지정할 수 있습니다.
+ `DuplicateFiles`: 파일 크기 및 콘텐츠를 기반으로 중복 파일 식별
+ `FilesByFileGroup`: 파일 그룹 멤버십별로 파일을 그룹화합니다.
+ `FilesByOwner`: 소유자별로 파일을 그룹화합니다.
+ `FilesByProperty`: 분류 속성별로 파일을 그룹화합니다.
+ `FileScreenAuditFiles`: 파일 검사 위반을 나열합니다.
+ `FoldersByProperty`: 관리 속성별로 폴더를 그룹화합니다.
+ `LargeFiles`: 지정된 크기 임계값을 초과하는 파일을 나열합니다.
+ `LeastRecentlyAccessed`: 최근에 액세스하지 않은 파일을 나열합니다.
+ `MostRecentlyAccessed`: 최근에 액세스한 파일을 나열합니다.
+ `QuotaUsage`: 할당량 사용량 통계를 표시합니다.
+ `ReportFormat (array)` - 선택 사항입니다. 출력 형식의 배열입니다. 다음 값을 지정할 수 있습니다.
+ `DHTML`: 동적 HTML 형식
+ `HTML`: 정적 HTML 형식
+ `XML`: XML 형식
+ `CSV`: 쉼표로 구분된 값 형식
+ `Text`: 일반 텍스트 형식
+ `Interactive (boolean)` - 선택 사항입니다. true로 설정하면가 대화형 보고서를 생성합니다. 대화형 보고서는 생성 후 수정할 수 없습니다.
+ `ScheduleConfigurations (hashtable)` - 보고서가 대화형인 경우를 제외하고 필요합니다. 다음 속성을 가진 일정 구성을 포함하는 해시 테이블:
+ `Time (datetime)`: 작업을 실행할 시기를 지정하는 DateTime 객체(필수)
+ `RunDuration (number)`: 작업을 실행하는 데 걸리는 시간(선택 사항)
+ `Weekly (array)`: 평일 배열(선택 사항)
+ `Monthly (array)`: 일 배열, 마지막 날에 `-1` 사용(선택 사항)
**보고서별 파라미터:**
+ `FileScreenAuditDaysSince (number)` - 선택 사항입니다. FileScreenAuditFiles 보고서의 경우 감사 이벤트를 포함할 일수를 지정합니다.
+ `FileScreenAuditUser (array)` - 선택 사항입니다. FileScreenAuditFiles 보고서의 경우 보고서에 포함할 사용자 계정 배열을 지정합니다. 이러한 사용자의 파일 검사 위반만 포함됩니다.
+ `FileGroupIncluded (array)` - 선택 사항입니다. FilesByFileGroup 보고서의 경우 포함할 파일 그룹을 지정합니다.
+ `FileOwnerFilePattern (string)` - 선택 사항입니다. FilesByOwner 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `PropertyName (string)` - 선택 사항입니다. FilesByProperty 보고서의 경우 그룹화할 분류 속성을 지정합니다.
+ `FolderPropertyName (string)` - 선택 사항입니다. FoldersByProperty 보고서의 경우 그룹화할 폴더 속성을 지정합니다.
+ `PropertyFilePattern (string)` - 선택 사항입니다. FilesByProperty 및 FoldersByProperty에서 결과를 필터링할 파일 패턴을 지정합니다.
+ `LargeFileMinimum (number)` - 선택 사항입니다. LargeFiles 보고서의 경우는 최소 파일 크기를 바이트 단위로 지정합니다.
+ `LargeFilePattern (string)` - 선택 사항입니다. LargeFiles 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `LeastAccessedMinimum (number)` - 선택 사항입니다. LeastRecentlyAccessed 보고서의 경우 마지막 액세스 이후 최소 일수를 지정합니다.
+ `LeastAccessedFilePattern (string)` - 선택 사항입니다. LeastRecentlyAccessed 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `MostAccessedMaximum (number)` - 선택 사항입니다. MostRecentlyAccessed 보고서의 경우 마지막 액세스 이후 최대 일수를 지정합니다.
+ `MostAccessedFilePattern (string)` - 선택 사항입니다. MostRecentlyAccessed 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `QuotaMinimumUsage (number)` - 선택 사항입니다. QuotaUsage 보고서의 경우 포함할 최소 할당량 사용률을 지정합니다.
**예**:
1. 월별 대용량 파일 보고서를 생성합니다.
```
$schedule = @{
Time = ("3:00 AM")
Monthly = @(1) # Run on first day
}
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
param($schedule)
New-FSxFSRMStorageReport -Name "Monthly Large Files" -Namespace "share\data" -ReportType "LargeFiles" -LargeFileMinimum 100MB -ReportFormat "HTML" -ScheduleConfigurations $schedule
}
```
2. 여러 네임스페이스 및 형식으로 주간 중복 파일 보고서를 생성합니다.
```
$schedule = @{
Time = ("12:00 AM")
Weekly = @('Sunday')
RunDuration = 4
}
$namespaces = @("share\docs", "[FolderUsage_MS=User Files]")
$reportFormats = @("HTML", "CSV")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $namespaces, $reportFormats) -ScriptBlock {
param($schedule, $namespaces, $reportFormats)
New-FSxFSRMStorageReport -Name "Weekly Duplicates" -Namespace $namespaces -ReportType "DuplicateFiles" -ReportFormat $reportFormats -ScheduleConfigurations $schedule
}
```
3. 즉시 실행되는 대화형 보고서를 생성합니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMStorageReport -Name "Find large files" -Namespace "share" -Interactive $true -ReportType "QuotaUsage"
}
```
#### Get-FSxFSRMStorageReport
**Get-FSxFSRMStorageReport**: 파일 시스템에서 하나 이상의 스토리지 보고서를 검색합니다. 보고서 구성 및 상태에 대한 세부 정보를 반환합니다.
**파라미터:**
+ `Name (array)` - 선택 사항입니다. 검색할 보고서 이름의 배열입니다. 이름을 지정하지 않으면 명령은 파일 시스템의 모든 스토리지 보고서를 반환합니다.
**예**:
1. 파일 시스템에서 모든 스토리지 보고서를 검색합니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMStorageReport
}
```
#### Remove-FSxFSRMStorageReport
**Remove-FSxFSRMStorageReport**: 파일 시스템에서 하나 이상의 스토리지 보고서를 제거합니다. 현재 실행 중인 보고서는 제거할 수 없습니다.
**파라미터:**
+ `Name (array)` - 필수 항목입니다. 제거할 보고서 이름의 배열입니다.
+ `PassThru (boolean)` - 선택 사항입니다. true로 설정하면 제거된 보고서 객체를 반환합니다.
**예**:
1. 단일 스토리지 보고서를 제거합니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMStorageReport -Name "Monthly Report" -PassThru
}
```
#### Set-FSxFSRMStorageReport
##### 파라미터
+ `Name (array)` - 필수 항목입니다. 수정할 보고서 이름의 배열입니다.
+ `Namespace (array)` - 선택 사항입니다. 분석할 경로 또는 폴더 유형의 배열입니다. 경로를 여러 형식으로 지정할 수 있습니다.
+ 폴더 경로
+ [폴더 분류](fsrm-file-classification.md#fsrm-management-properties). 예: [FolderUsage\$1MS="User Files"]
+ `ReportType (array)` - 선택 사항입니다. 생성할 보고서 유형의 배열입니다. 다음 값을 지정할 수 있습니다.
+ `DuplicateFiles`: 파일 크기 및 콘텐츠를 기반으로 중복 파일 식별
+ `FilesByFileGroup`: 파일 그룹 멤버십별로 파일을 그룹화합니다.
+ `FilesByOwner`: 소유자별로 파일을 그룹화합니다.
+ `FilesByProperty`: 분류 속성별로 파일을 그룹화합니다.
+ `FileScreenAuditFiles`: 파일 검사 위반을 나열합니다.
+ `FoldersByProperty`: 관리 속성별로 폴더를 그룹화합니다.
+ `LargeFiles`: 지정된 크기 임계값을 초과하는 파일을 나열합니다.
+ `LeastRecentlyAccessed`: 최근에 액세스하지 않은 파일을 나열합니다.
+ `MostRecentlyAccessed`: 최근에 액세스한 파일을 나열합니다.
+ `QuotaUsage`: 할당량 사용량 통계를 표시합니다.
+ `ReportFormat (array)` - 선택 사항입니다. 출력 형식의 배열입니다. 다음 값을 지정할 수 있습니다.
+ `DHTML`: 동적 HTML 형식
+ `HTML`: 정적 HTML 형식
+ `XML`: XML 형식
+ `CSV`: 쉼표로 구분된 값 형식
+ `Text`: 일반 텍스트 형식
+ `ScheduleConfigurations (hashtable)` - 보고서가 대화형인 경우를 제외하고 필요합니다. 다음 속성을 가진 일정 구성을 포함하는 해시 테이블:
+ `Time (datetime)`: 작업을 실행할 시기를 지정하는 DateTime 객체(필수)
+ `RunDuration (number)`: 작업을 실행하는 데 걸리는 시간(선택 사항)
+ `Weekly (array)`: 평일 배열(선택 사항)
+ `Monthly (array)`: 일 배열, 마지막 날에 `-1` 사용(선택 사항)
+ `PassThru (boolean)` - 선택 사항입니다. true로 설정하면 수정된 보고서 객체를 반환합니다.
##### 보고서별 파라미터
+ `FileScreenAuditDaysSince (number)` - 선택 사항입니다. FileScreenAuditFiles 보고서의 경우 감사 이벤트를 포함할 일수를 지정합니다.
+ `FileScreenAuditUser (array)` - 선택 사항입니다. FileScreenAuditFiles 보고서의 경우 보고서에 포함할 사용자 계정 배열을 지정합니다. 이러한 사용자의 파일 검사 위반만 포함됩니다.
+ `FileGroupIncluded (array)` - 선택 사항입니다. FilesByFileGroup 보고서의 경우 포함할 파일 그룹을 지정합니다.
+ `FileOwnerFilePattern (string)` - 선택 사항입니다. FilesByOwner 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `PropertyName (string)` - 선택 사항입니다. FilesByProperty 보고서의 경우 그룹화할 분류 속성을 지정합니다.
+ `FolderPropertyName (string)` - 선택 사항입니다. FoldersByProperty 보고서의 경우 그룹화할 폴더 속성을 지정합니다.
+ `PropertyFilePattern (string)` - 선택 사항입니다. FilesByProperty 및 FoldersByProperty에서 결과를 필터링할 파일 패턴을 지정합니다.
+ `LargeFileMinimum (number)` - 선택 사항입니다. LargeFiles 보고서의 경우는 최소 파일 크기를 바이트 단위로 지정합니다.
+ `LargeFilePattern (string)` - 선택 사항입니다. LargeFiles 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `LeastAccessedMinimum (number)` - 선택 사항입니다. LeastRecentlyAccessed 보고서의 경우 마지막 액세스 이후 최소 일수를 지정합니다.
+ `LeastAccessedFilePattern (string)` - 선택 사항입니다. LeastRecentlyAccessed 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `MostAccessedMaximum (number)` - 선택 사항입니다. MostRecentlyAccessed 보고서의 경우 마지막 액세스 이후 최대 일수를 지정합니다.
+ `MostAccessedFilePattern (string)` - 선택 사항입니다. MostRecentlyAccessed 보고서의 경우 결과를 필터링할 파일 패턴을 지정합니다.
+ `QuotaMinimumUsage (number)` - 선택 사항입니다. QuotaUsage 보고서의 경우 포함할 최소 할당량 사용률을 지정합니다.
##### 예시:
1. 기존 보고서의 일정 및 형식을 업데이트합니다.
```
$schedule = @{
Time = ("3:00 AM")
Monthly = @(1)
}
$reportFormats = @("HTML", "CSV")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $reportFormats) -ScriptBlock {
param($schedule, $reportFormats)
Set-FSxFSRMStorageReport -Name "Monthly Report" -ScheduleConfigurations $schedule -ReportFormat $reportFormats -PassThru
}
```
### 보고서 실행 명령
#### Start-FSxFSRMStorageReport
##### 파라미터
+ `Name (array)` - 필수 항목입니다. 시작할 보고서 이름의 배열입니다.
+ `Queue (boolean)` - 선택 사항입니다. true로 설정하면가 다음 5분 이내에 실행할 보고서를 대기열에 추가합니다. 이 기간 동안 대기 중인 모든 보고서는 함께 실행됩니다. false로 설정하거나 지정하지 않으면 보고서가 즉시 시작됩니다.
+ `RunDuration (number)` - 선택 사항입니다. 보고서를 취소하기 전에 실행해야 하는 시간을 지정합니다. 유효한 값: `-1` \$1 `2147483`. 특수 값:
+ `0`: 완료까지 실행
+ `-1`: 취소될 때까지 실행
지정하지 않으면가 완료될 때까지 실행됩니다.
##### 예제
1. 스토리지 보고서를 즉시 시작합니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Monthly Report"
}
```
2. 기간 제한이 있는 스토리지 보고서를 대기열에 넣습니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Quarterly Report" -Queue: $true -RunDuration 4
}
```
#### Stop-FSxFSRMStorageReport
##### 파라미터
+ `Name (array)` - 필수 항목입니다. 중지할 보고서 이름의 배열입니다.
##### 예시:
1. 단일 스토리지 보고서를 중지합니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Stop-FSxFSRMStorageReport -Name "Monthly Report"
}
```
#### Wait-FSxFSRMStorageReport
##### 파라미터
+ `Name (array)` - 필수 항목입니다. 대기할 보고서 이름의 배열입니다.
+ `Timeout (number)` - 선택 사항입니다. 보고서가 완료될 때까지 기다리는 시간을 초 단위로 지정합니다. 보고서가 완료되기 전에 제한 시간이 만료되면 명령은를 반환하지만 보고서 생성은 백그라운드에서 계속 실행됩니다. 유효한 값: `-1` \$1 `2147483`. 특수 값:
+ `-1`: 보고서가 완료될 때까지 무기한 대기(기본값)
+ `0`: 현재 상태를 확인하고 기다리지 않고 즉시 반환
##### 예시:
1. 스토리지 보고서가 완료될 때까지 무기한 기다립니다.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Wait-FSxFSRMStorageReport -Name "Monthly Report"
}
```