次の方法で共有


New-AzGalleryInVMAccessControlProfileVersionConfig

ローカル PSGalleryInVmAccessControlProfileVersion オブジェクトを作成します。

構文

Default (既定)

New-AzGalleryInVMAccessControlProfileVersionConfig
    -Name <String>
    -Location <String>
    -Mode <String>
    -DefaultAccess <String>
    -TargetLocation <String[]>
    [-ExcludeFromLatest]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

説明

New-AzGalleryInVMAccessControlProfileVersionConfig コマンドレットは、ローカル PSGalleryInVmAccessControlProfileVersion オブジェクトを作成します。このオブジェクトを New-AzGalleryInVMAccessControlProfileVersion コマンドレットと共に使用して、Azure の VM アクセス制御プロファイル バージョンに新しいギャラリーを作成できます。
Add-AzGalleryInVMAccessControlVersionRulesIdentityAdd-AzGalleryInVMAccessControlVersionRulesPrivilegeAdd-AzGalleryInVMAccessControlVersionRulesRolesRoleAssignment コマンドレットを使用して、PSGalleryInVmAccessControlProfileVersion オブジェクトにルールを追加できます。

例 1

New-AzGalleryInVMAccessControlProfileVersionConfig -Name "myProfileVersion" -Location "West US 2" -Mode "Audit" -DefaultAccess "Deny" -TargetLocation @("West US", "West US 2") -ExcludeFromLatest

指定されたパラメーターを使用して、ローカル PSGalleryInVmAccessControlProfileVersion オブジェクトを作成します。

例 2

$CPVersionConfig = New-AzGalleryInVMAccessControlProfileVersionConfig -Name "myProfileVersion" -Location "West US 2" -Mode "Audit" -DefaultAccess "Deny" -TargetLocation @("West US", "West US 2") `
| Add-AzGalleryInVMAccessControlProfileVersionRulesPrivilege -PrivilegeName "GoalState" -Path "/machine" -QueryParameter @{ comp = "goalstate" } `
| Add-AzGalleryInVMAccessControlProfileVersionRulesRole -RoleName "Provisioning" -Privilege @("GoalState") `
| Add-AzGalleryInVMAccessControlProfileVersionRulesIdentity -IdentityName "WinPA" -UserName "SYSTEM" -GroupName "Administrators" -ExePath "C:\Windows\System32\cscript.exe" -ProcessName "cscript" `
| Add-AzGalleryInVMAccessControlProfileVersionRulesRoleAssignment -Role "Provisioning" -Identity @("WinPA")

ローカル PSGalleryInVmAccessControlProfileVersion オブジェクトを作成し、ルールを追加します。

パラメーター

-DefaultAccess

このプロパティを使用すると、要求がホスト エンドポイントへのアクセスを許可されるかどうかを指定できます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExcludeFromLatest

true に設定すると、最新バージョンのリソース プロファイルからデプロイされた Virtual Machines では、このプロファイル バージョンは使用されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Location

VM アクセス制御プロファイル バージョンのギャラリーの場所。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Mode

このプロパティを使用すると、アクセス制御規則を監査モード、強制モード、無効のどちらにするかを指定できます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

VM アクセス制御プロファイル バージョンのギャラリーの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:GalleryInVMAccessControlProfileVersionName

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TargetLocation

リソース プロファイルのバージョンがレプリケートされるターゲット リージョンの名前。 このプロパティは更新可能です。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

String

SwitchParameter

出力

PSGalleryInVMAccessControlProfileVersion