Get-Label
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Get-Label コマンドレットを使用して、organizationの秘密度ラベルを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
説明
注: organizationに han 1000 の秘密度ラベルが多い場合、PowerShell セッションにタイムアウト設定が設定されると、パフォーマンスの問題が発生する可能性があります。 ラベルをより効率的に取得するには、SkipValidations パラメーターを使用します。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Get-Label
次の使用例は、organization内のすべての秘密度ラベルの概要リストを返します。
例 2
Get-Label -Identity "Engineering Group" | Format-List
次の使用例は、Engineering Group という名前の秘密度ラベルの詳細情報を返します。
パラメーター
-Identity
適用対象: セキュリティ & コンプライアンス
Identity パラメーターは、表示する秘密度ラベルを指定します。 ラベルを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | ComplianceRuleIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IncludeDetailedLabelActions
適用対象: セキュリティ & コンプライアンス
IncludeDetailedLabelActions パラメーターは、読みやすくするためにラベル アクションをプロパティに展開するかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReturnModernLabelScheme
適用対象: セキュリティ & コンプライアンス
{{ Fill ReturnModernLabelScheme Description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipValidations
適用対象: セキュリティ & コンプライアンス
SkipValidations スイッチは、秘密度ラベルで構成された暗号化プロパティの取得をスキップするかどうかを指定します。 このスイッチで値を指定する必要はありません。
ラベルが 1,000 を超える組織では、この swtich を使用してラベルの取得に必要な時間を短縮できるため、コマンドレットのタイムアウトの問題を防ぐことができます Get-Label。
注: このスイッチを使用しても、ラベルを取得しても検証はスキップされません。 ラベル用に構成されている場合にのみ、暗号化テンプレートプロパティの取得はスキップされます。 これらのプロパティは、Get-Label コマンドの Identity パラメーターを使用して個別に取得できます。
このスイッチは、ラベル アプリケーションや配布には影響しません。 この制限は、CRUD 操作のラベルをフェッチする場合にのみ存在します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ValidateContentTypeRemoval
適用対象: セキュリティ & コンプライアンス
{{ Fill ValidateContentTypeRemoval Description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。